1. REST API for Oracle Identity Governance Self Service
  2. Tasks
  3. Certification

Update Lineitems Associated with Specified Task

put

/iam/governance/selfservice/api/v1/certifications/{certid}/tasks/{taskid}/lineitems/{lineitemid}

Updates the line item specified by the line item ID associated with the taskid . The updates actions which can be done to the line items are, claim, revoke, abstain, complete, sign-off, edit comment, Reset Status.

Request

Supported Media Types
Path Parameters
Body ()
Action to be taken on the LineItem
Root Schema : SingleLineItemRequestPayLoad
Type: object
Show Source
Nested Schema : LineItemRequestPayLoad
Type: object
Show Source
Nested Schema : lineItemDetails
Type: array
Show Source
Nested Schema : fields
Type: array
Show Source
Nested Schema : PutCertificationsTasksByTaskIdResponseField
Type: object
Show Source
Nested Schema : LineItemDetailRequestPayLoad
Type: object
Show Source
Nested Schema : fields
Type: array
Show Source
Back to Top

Response

Supported Media Types

200 Response

Successful
Headers
Body ()
Root Schema : SingleLineItemResponsePayLoad
Type: object
Show Source
Nested Schema : LineItemResponsePayLoad
Type: object
Show Source
Nested Schema : lineItemDetails
Type: array
Show Source
Nested Schema : LineItemDetailResponsePayLoad
Type: object
Show Source
Nested Schema : LinkDataInstances
Type: object
Show Source

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error

Default Response

Unexpected error
Back to Top

Examples

This example demonstrates the ability to update a single line item associated with a certification task. 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/certifications/21/tasks/e1d5e5dd-5f9e-4747
-bd5f-e00dc0b99d58/lineitems/21"

Example of PUT Request Body

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

{
    "lineItem": {
        "action": "Claim",
        "fields": [
                    {
                      "name": "comment",
                      "value": "test Claim"
                    }
                  ]
    }
}

Example of PUT Response Body

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

{
    "links": [
        {
            "rel": "self",
            "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/21/tasks/e1d5e5dd-5f9e-
4747-bd5f-e00dc0b99d58/lineitems/21"
        }
    ],
    "lineItem": {
        "action": "Claim",
        "status": "SUCCESS",
        "lineItemId": "21"
    }
}
Back to Top