Change your password

Requests

HTTP verb Endpoint Description

PATCH

/rest/v1/user/pwd

Change password

For all requests:
Domain Type: any

Change password

Algorithm:

  • 1. Check if the 'current_pwd' and 'new_pwd' fields are present in the JSON body of the request.

  • 2. Checks if the current password is correct.

  • 3. Send a change request to MDC and check the password complexity policy.

The password to be set must satisfy the password complexity policy configured in the master domain (settings.user_pwd_policy).

Request

Request example
PATCH /rest/v1/user/ext HTTP/1.1
Content-Type: application/json

{
  "current_pwd": "mypwd",
  "new_pwd": "39hV0Z"
}

Response

Example of a successful answer
HTTP/1.1 200 OK

{
  "error_code": 0,
  "result": true
}
Example of an unsuccessful response
HTTP/1.1 412 Precondition Failed

{
  "error_code": 1501,
  "error_message": "pwd doesn't satisfy policy. Expected symbols: [A-Za-z0-9_-.~!]",
  "error_details": {
    "field": "pwd"
  }
}

Error codes

Possible message types (field 'error_details.msg_code'): 100xx, 101xx, 102xx, 154xx.