Skip to content

Change password ​

Changes the signed-in user's password. The user is taken from the bearer token.

POST /fieldservicegateway/usermanagement/v3/auth/password-change

Request ​

FieldTypeRequiredDescription
current_passwordstringyesPassword the user has now. 1–72 characters
new_passwordstringyes10–72 characters, with an uppercase letter, a lowercase letter, a digit, and a symbol. No spaces

Example ​

json
{
  "current_password": "Current-Pass1!",
  "new_password": "New-Passw0rd!"
}

cURL ​

bash
curl --request POST 'https://[BASE_URL]/fieldservicegateway/usermanagement/v3/auth/password-change' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {{x-api-key}}' \
  --header 'Authorization: {{Authorization}}' \
  --header 'Asurion-correlationid: correlation-id' \
  --header 'Asurion-enduser: end-user' \
  --header 'Asurion-sourcesystem: source-system' \
  --header 'Asurion-serviceprovider: company-id' \
  --header 'Asurion-client: default' \
  --data '{
    "current_password": "Current-Pass1!",
    "new_password": "New-Passw0rd!"
  }'

Response ​

200 OK

json
{
  "success": true,
  "message": "Password changed successfully"
}

Errors ​

StatusCodeWhen
400VALIDATION_ERRORA password is missing, or the new password does not meet the rules
400SSO_ONLY_ACCOUNTPassword change is not available for a single sign-on account
401The bearer token is missing or invalid
404NOT_FOUNDNo identity was found for the signed-in user
500INTERNAL_ERRORSomething unexpected failed, including a current password that does not match