Jump to

• Request
• Response
• Examples

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: string
  Unique identifier of User whose challenge responses are to be updated.

Body ()

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

Root Schema : ChallengesUpdateRequest

Type: object

Show Source

• challengequestions(optional): 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(optional): string
• value(optional): string

{
    "properties":{
        "name":{
            "type":"string"
        },
        "value":{
            "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 : ChallengesUpdatedResponse

Type: object

Show Source

• status(optional): string

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

Back to Top