Jump to

• Request
• Response
• Examples

Update Account Password

put

/iam/governance/selfservice/api/v1/accounts/{accountid}/password

Changes the password for the specified account. The password validation with the appropriate password policies will be performed by Oracle Identity Manager. If there the password is not valid as per the password policies then the operation will fail.

Request

Supported Media Types

• application/json

Path Parameters

• accountid: string
  Account id whose password is to be changed

Body ()

New password for the account.

Root Schema : AccountUpdatePasswordRequest

Type: object

Show Source

• password(optional): string
• requestId(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "password":{
            "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 : AccountPasswordUpdateResponse

Type: object

Show Source

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

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "status":{
            "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

403 Response

Forbidden

404 Response

Requested entity not found

500 Response

Internal Server Error

Default Response

Unexpected error

Back to Top

Examples

This example demonstrates the ability to update the password to a given account. 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/accounts/1/password

Example of PUT Request Body

The following example shows the contents of the request body in JSON format.

{
  "requestId": "101",
  "password": "ACCOUNT_PASSWORD"
}

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
    "links": [
        {
            "rel": "self",
            "href": "http://pseudo.oracle.com:PORT/iam/governance/selfservice/api/v1/accounts/1/password"
        }
    ],
    "requestId": "101",
    "status": "UPDATED",
    "id": "1"
}

Back to Top