REST API for Oracle Identity Governance Self Service

Update Challenge Responses for a User Based on User ID

put

/iam/governance/selfservice/api/v1/users/{uuid}/challengequestions

Updates the challenge responses for the user specified by the user ID. The action can be performed only in scenarios where the challenge responses are enabled.

Request

Supported Media Types

application/json

Path Parameters

uuid(required): string

Unique identifier of User whose challenge responses are to be updated.

Captures the challenges and responses to be updated for the specified user.

Root Schema : ChallengesUpdateRequest

Type: object

Show Source

challengequestions: array challengequestions

{
    "properties":{
        "challengequestions":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Fields"
            }
        }
    }
}

Nested Schema : challengequestions

Type: array

Show Source

Array of: object Fields

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

Nested Schema : Fields

Type: object

Show Source

name: string
value: string

{
    "properties":{
        "name":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : ChallengesUpdatedResponse

Type: object

Show Source

status: string

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

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error

Examples

This example demonstrates the ability to update the challenge questions for a user. 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/{uuid}/challengequestions

Example of PUT Request Body

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

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

Example of Response Body

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

{
  "status": "success"
}