Credentials

Delete username credential

Delete username credential. The user will not be able to login anymore

DELETE /orgs/{org}/credentials/{username}

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Masmovil
org	path	string	true	a orgID of Grupo Masmovil

Request example

1
2
3
4
5



curl -X DELETE https://credentials.masstack.com/v1/orgs/{org}/credentials/{username} \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
204	No Content	OK	None
400	Bad Request	Error response	ErrorDto
401	Unauthorized	Error response	ErrorDto
403	Forbidden	Error response	ErrorDto
404	Not Found	Error response	ErrorDto
409	Conflict	Error response	ErrorDto
500	Internal Server Error	Error response	ErrorDto

RetrieveUsernameCredential

Get usernames credential. It´s main goal its to get information about a credential without involving checking directly in BD. It will not return credential password

GET /orgs/{org}/credentials/{username}

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil

Request example

1
2
3
4
5



curl -X GET https://credentials.masstack.com/v1/orgs/{org}/credentials/{username} \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
200	OK	Credential retrieved during check process	Credential
404	Not Found	Error response	ErrorDto

Enable/Disable credential.

Username should be exist.The token must exist and must have been created for this user to change their password

PATCH /orgs/{org}/credentials/{username}

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil
body	body	InboundChangeStatusCredential	true	Password and security token.

Request body - instance of InboundChangeStatusCredential

1
2
3
4


{
  "enabled": true,
  "require2fa": true
}

Name	Type	Required	Description
enabled	boolean	true	Enables or disables the credential
require2fa	boolean	false	If true the 2fa is required

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10



curl -X PATCH https://credentials.masstack.com/v1/orgs/{org}/credentials/{username} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'enabled': true,
  'require2fa': true
}" 

Responses

Code	Meaning	Description	Schema
204	No Content	OK	None
400	Bad Request	Error response	ErrorDto
401	Unauthorized	Error response	ErrorDto
403	Forbidden	Error response	ErrorDto
404	Not Found	Error response	ErrorDto
500	Internal Server Error	Error response	ErrorDto

Create username's credential without password.

Create the user's credential without activating it and without passwordGenerate a token required to change the password for this username. With this token, the username will be able to set password with update endpoint

POST /orgs/{org}/credentials/{username}

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil

Request example

1
2
3
4
5



curl -X POST https://credentials.masstack.com/v1/orgs/{org}/credentials/{username} \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
201	Created	Security token to set or change password	TokenResponse
400	Bad Request	Error response	ErrorDto
401	Unauthorized	Error response	ErrorDto
403	Forbidden	Error response	ErrorDto
404	Not Found	Error response	ErrorDto
409	Conflict	Error response	ErrorDto
500	Internal Server Error	Error response	ErrorDto

Update username credential with this password.

Username should be exist.The token must exist and must have been created for this user to change their password

PUT /orgs/{org}/credentials/{username}

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil
body	body	InboundCredential	true	Password and security token.

Request body - instance of InboundCredential

1
2
3
4


{
  "password": "string",
  "token": "string"
}

Name	Type	Required	Description
password	string	true	New password for the customer credential
token	string	true	Security token issued in order to change passwords

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10



curl -X PUT https://credentials.masstack.com/v1/orgs/{org}/credentials/{username} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'password': 'string',
  'token': 'string'
}" 

Responses

Code	Meaning	Description	Schema
204	No Content	OK	None
400	Bad Request	Error response	ErrorDto
401	Unauthorized	Error response	ErrorDto
403	Forbidden	Error response	ErrorDto
404	Not Found	Error response	ErrorDto
409	Conflict	Error response	ErrorDto
500	Internal Server Error	Error response	ErrorDto

Request for change the password

Generate a token required to change the password for this usernameWith this token, the username will be able to change password with update endpoint

POST /orgs/{org}/credentials/{username}/change_password

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil

Request example

1
2
3
4
5



curl -X POST https://credentials.masstack.com/v1/orgs/{org}/credentials/{username}/change_password \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
201	Created	Security token to set or change password	TokenResponse
400	Bad Request	Error response	ErrorDto
401	Unauthorized	Error response	ErrorDto
403	Forbidden	Error response	ErrorDto
404	Not Found	Error response	ErrorDto
409	Conflict	Error response	ErrorDto
500	Internal Server Error	Error response	ErrorDto