Update requests

put

/iam/governance/selfservice/api/v1/requests

Updates request(s). The Oracle Identity Manager request ID should be specified in the payload along with the update details to update the request. The request data can updated or the request status can be updated. Based on the Type of action attribute provided the SOA or OIM action is executed. Here the Action's could be APPROVE,RELEASE, RESUME, REASSIGN, REJECT, ESCALATE, SUSPEND, WITHDRAW, CLAIM, SAVE, CREATESUBTASK, SKIPASSIGNMENT . Addition to these we have one additions operation of CLOSE, which can be performed on the Requests. An Additional TaskId can be provided with the request to exclusively perform operation on the specific task. If the taskId is not provided then the first task in the list will be picked for the operation requested on the requestId.

Request

Supported Media Types
Body ()
List of update attributes for updating requests
Root Schema : BulkReqUpdateRequest
Type: object
Show Source
Nested Schema : requests
Type: array
Show Source
Nested Schema : ReqUpdateRequestEntity
Type: object
Show Source
Nested Schema : assignees
Type: array
Show Source
Nested Schema : reqTargetEntities
Type: array
Show Source
Nested Schema : PendingApprovalsAssigneeNames
Type: object
Show Source
Nested Schema : reqTargetEntityRequestPayload
Type: object
Show Source
Nested Schema : appFormData
Type: array
Show Source
Nested Schema : Fields
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Successful
Headers
Body ()
Root Schema : BulkReqUpdateResponse
Type: object
Show Source
Nested Schema : requests
Type: array
Show Source
Nested Schema : ReqUpdateResponseEntity
Type: object
Show Source
Nested Schema : LinkDataInstances
Type: object
Show Source

401 Response

Unauthorized

403 Response

Forbidden

404 Response

Resource not found

500 Response

Internal Server Error
Back to Top

Examples

This example demonstrates the ability to approve pending requests.

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/requests

Example of PUT Request Body

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

{
    "requests": [
        {
            "id": "1003",
            "actionComment": "rest sysadmin approved",
            "action": "approve"
        },
        {
            "id": "23",
            "actionComment": "rest sysadmin reject",
            "action": "reject"
        }
    ]
}

Example of PUT Response Body

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

{
    "links": [
        {
            "rel": "self",
            "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests"
        }
    ],
    "requests": [
        {
            "links": [
                {
                    "rel": "self",
                    "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/1003"
                }
            ],
            "id": "1003",
            "status": "SUCCESS"
        },
        {
            "links": [
                {
                    "rel": "self",
                    "href": "http://pseudo.com/iam/governance/selfservice/api/v1/requests/23"
                }
            ],
            "id": "23",
            "status": "SUCCESS"
        }
    ]
}
Back to Top