Jump to

• Request
• Response
• Examples

Submit Password Reset Request

post

/iam/governance/selfservice/api/v1/unauthservice/passwordreset

Submits the password reset request based on template data. The challenge questions along with their respective answers should be send as part of the request to enable Oracle Identity Manager validate the challenge responses.

Request

Supported Media Types

• application/json

Body ()

Attributes for resetting password

Root Schema : PasswordResetRequest

Type: object

Show Source

• challengeQuestions(optional): array challengeQuestions
• confirmPassword(optional): string
• newPassword(optional): string
• oldPassword(optional): string
• userId(optional): string

{
    "properties":{
        "userId":{
            "type":"string"
        },
        "oldPassword":{
            "type":"string"
        },
        "newPassword":{
            "type":"string"
        },
        "confirmPassword":{
            "type":"string"
        },
        "challengeQuestions":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/QueAndAnsMap"
            }
        }
    }
}

Nested Schema : challengeQuestions

Type: array

Show Source

• Array of: object QueAndAnsMap

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

Nested Schema : QueAndAnsMap

Type: object

Show Source

• <ChallengeQuestion>(optional): string

{
    "properties":{
        "<ChallengeQuestion>":{
            "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 : PasswordResetResponse

Type: object

Show Source

• status(optional): string

{
    "properties":{
        "status":{
            "type":"string"
        }
    }
}

404 Response

Resource not found

500 Response

Internal Server Error

Default Response

Unexpected error

Back to Top

Examples

This demonstrates the ability to reset the user 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 POST  -d @post.json https://pseudo.com/iam/governance/selfservice/api/v1/unauthservice/passwordreset

Example of POST Request Body

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

{
  "userId": "[e-mail]",
  "newPassword": "PASSWORD",
  "challengeQuestions": [
    {
      "name": "What is your mother's maiden name?",
      "value": "doe"
    },
    {
      "name": "What is the name of your pet?",
      "value": "puppy"
    },
    {
      "name": "What is the city of your birth?",
      "value": "new york"
    }
  ]
}

Example of POST Response Body

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

{
    "status": "true"
}

Back to Top