Update a users password

POST/api/security/users/{userIdentifier}/credentials/password

Parameter

Name	Parameter type	Type	Format	Description
UserIdentifier(required)	path	string	user identifier	For convenience, User resources can be referenced by using one of several identifiers - username, email address or Id.

Responses

HTTP status code	Reason	Model
200	OK - password updated successfully
401	Unauthorized	Error
403	Forbidden	Error
404	User not found	Error
409	Invalid existing password	Error
422	Password invalid	Error
500	Internal server error	Error

Examples

JSON

POST: /api/security/users/9bb89380-fd49-41a5-ab2f-fc25e482a251/credentials/password
{
    "existing": "m4rl451ng3r",
    "new": "pr0j3ctM4yh3m"
}

JSON

POST: /api/security/users/t.durden/credentials/password
{
    "existing": "m4rl451ng3r",
    "new": "pr0j3ctM4yh3m"
}

Example request for a System Adminstrator member

JSON

POST: /api/security/users/9bb89380-fd49-41a5-ab2f-fc25e482a251/credentials/password
{
    "new": "pr0j3ctM4yh3m"
}

JavaScript

POST: /api/security/users/t.durden@fightclub.com/credentials/password
{
    "new": "pr0j3ctM4yh3m"
}

Remarks

If the existing password is wrong then a 409 Conflict status is returned. If the new password does not meet the user password policy then a 422 Unprocessable Entity status is returned.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.

New support request