Jump to

• Request
• Response
• Examples

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: string
  User's unique identifier

Body ()

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.

Root Schema : UserUpdatePasswordRequest

Type: object

Show Source

• confirmPassword(optional): string
• newPassword(optional): string
• oldPassword(optional): string
• requestId(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "oldPassword":{
            "type":"string"
        },
        "newPassword":{
            "type":"string"
        },
        "confirmPassword":{
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful

Headers

• ResponseTime: string
  Captures the time in milliseconds taken for processing the request.

Body ()

Root Schema : UserPasswordUpdateResponse

Type: object

Show Source

• id(optional): string
• links(optional): array links
• requestId(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "id":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkDataInstances"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object LinkDataInstances

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LinkDataInstances"
    }
}

Nested Schema : LinkDataInstances

Type: object

Show Source

• href(optional): string
• rel(optional): string

{
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error

Back to Top

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"
}

Back to Top