POST /users/{userId}/credentials/change-password

Request

Resource URL

POST https://api.ft.com/users/{userId}/credentials/change-password

For security reasons requests must be made over HTTPS.

Parameters

Not supported. Do not supply any query parameters.

Request Headers

HeaderValue
Content-Type
application/json
X-Api-Key <API key value>

Request Body

A json representaion of the Change Password Request an example of which is shown below

{
  “password”: “newPassword”,
  “token”: “SDKAJKLJDK2213JK2JSKLDJSAKLJFKLJ.ASNDI2J1JJ2JEK2J”,
  “oldPassword”: “oldPassword”,
  “reasonForChange”: “[reset-password | concurrency-detected | b2b-account-created | owner-requested | masquerader-requested | passwordless-signup]”
}

Response

HTTP Status Codes

Http StatusDescription
200 OK The user credentials were successfully updated
400 Bad request The request was invalid. You may refer to response for details around why the request was invalid
403 Forbidden Invalid API key
415 Unsupported Media Type Ensure you use the correct Content-Type header in the request as indicated in the Request Headers section above

200 OK - The user password was changed

400 Bad request - The request was invalid 

An error response with the following format.

{
“errors” : [ { “field”: “{field}”, “code”: “{error code}”, “message”: “{error message}” } ] }

403 Forbidden - Your access to the API endpoint was denied

Make sure you are using a valid API key. If you are sure your are using a valid API key and problems persist, contact us for assistance.

415 Unsupported Media Type - Ensure you use the correct Content-Type header

Make sure you use Content-Type header with value “application/json” in the request.