Update User Password
put
/iam/governance/selfservice/api/v1/users/{uuid}/password
Updates the password of the user specified by user ID. The password is validated against the applicable password policies before persisting the password. The logged in user's "uuid" is validated. If the "uuid" mentioned in the path parameter is different than that of the logged in user's unique identifier an exception is thrown.
Request
Supported Media Types
- application/json
Path Parameters
-
uuid(required): string
User's unique identifier
In case of the self change password scenario the user needs to provide the old password, new password and confirm password. If the new password and confirm password do not match Oracle Identity Manager thrown an appropriate exception.
Response
Supported Media Types
- application/json
200 Response
Successful
Headers
-
ResponseTime: string
Captures the time in milliseconds taken for processing the request.
401 Response
Unauthorized
404 Response
Requested entity not found
500 Response
Internal Server Error
Examples
This example demonstrates the ability to update a user’s password. The information shown here is against a pseudo system and serves as a prototype.
cURL Example
curl -H "Content-Type: application/json" -H "X-Requested-By: <anyvalue>" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/users/5/password
Example of PUT Request Body
The following example shows the contents of the request body in JSON format.
{
"oldPassword": "PASSWORD",
"newPassword": "PASSWORD",
"confirmPassword": "PASSWORD"
}Example of PUT Response Body
The following example shows the contents of the response body in JSON format.
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/5"
}
],
"id": "5"
}