REST API for Oracle Identity Governance Self Service

Get Password Reset Template

get

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

Returns password reset template that is used for submitting password reset request.

Request

Supported Media Types

application/json

Query Parameters

userId(required): string

Returns the challenge response questions for the specified User ID. The user ID should map to the user Login attribute of the user in Oracle Identity Manager.

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : GetPasswordResetResponse

Type: object

Show Source

challengeQuestions: array challengeQuestions

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

{
    "properties":{
        "<ChallengeQuestion>":{
            "type":"string"
        }
    }
}

404 Response

Resource not found

500 Response

Internal Server Error

Default Response

Unexpected error

Examples

This example retrieves the password reset information for a given user. The information shown here is against a pseudo system and serves as a prototype.

cURL Example

curl  -H "Content-Type: application/json"  -X GET  https://pseudo.com/iam/governance/selfservice/api/v1/unauthservice/passwordreset?userId=manas

Example of GET Response Body

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

{
    "challengeQuestions": [
        "What is the name of your pet?",
        "What is the city of your birth?",
        "What is your mother's maiden name?"
    ]
}