Action Certification Tasks
-
/certifications GET
returns the certifications for the logged in user -
/certifications/{certid} GET
returns the details of the certification -
/certifications/{certid}/tasks GET
returns all tasks associated with the certification -
/certification/{certid}/tasks PUT
updates all tasks associated with the certification -
/certifications/{certid}/tasks/{taskid} GET
returns the details of the given task -
/certifications/{certid}/tasks/{taskid} PUT
allows the update to a task, such as expire the task, create a proxy for the task, and so on -
/certifications/{certid}/tasks/{taskid}/lineitems/ GET
returns the line items associated with the task -
/certifications/{certid/tasks/{taskid}/lineitems PUT
updates the action associated with a line item, such as claim, revoke abstain, complete, and so on -
/certifications/{certid}/tasks/{taskid}/lineitems/{lineitemid} GET
returns the details of a line item associated with a task -
/certifications/{certid}/tasks/[taskid}/lineitems/{linieitemid} PUT
updates the action associated with a single line item
cURL Example for Retrieving Certifications
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications?offset=1&limit=10" }, { "rel": "first", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications?offset=1&limit=10" } ], "count": 1, "hasMore": false, "totalResult": -1, "certifications": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677" } ], "state": "ASSIGNED", "name": "userCert [ Ajay Arora ]", "type": "User", "id": "1", "asignee": "aarora", "createdDate": "2019-07-02T17:05:21Z", "soaTaskId": "3958c454-a7bb-4390-ba28-36b90c1acf42", "taskId": "164b640d-e192-4177-8d1b-dc440e260677" } ] }
cURL Example for Retrieving Certification Details
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1" } ], "certificationDefinitions": [ { "name": "status", "value": "New" }, { "name": "assignee", "value": "17" }, { "name": "createdDate", "value": "2019-07-02T17:05:19Z" }, { "name": "name", "value": "userCert [ Ajay Arora ] " }, { "name": "id", "value": "1" }, { "name": "percentComplete", "value": 0 }, { "name": "type", "value": "User" }, { "name": "users", "value": 1 }, { "name": "roleAssignments", "value": "0 of 2 completed" }, { "name": "accountAssignments", "value": "0 of 0 completed" }, { "name": "entitlementAssignments", "value": "0 of 0 completed" } ] }
cURL Example for Retrieving Certification Tasks
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks" } ], "count": 1, "certifications": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677" } ], "state": "ASSIGNED", "name": "userCert [ Ajay Arora ]", "type": "User", "id": "1", "asignee": "aarora", "createdDate": "2019-07-02T17:05:21Z", "soaTaskId": "3958c454-a7bb-4390-ba28-36b90c1acf42", "taskId": "164b640d-e192-4177-8d1b-dc440e260677" } ] }
cURL Example for Updating Certification Tasks
curl -H "Content-Type: application/json" -X PUT -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks
PUT Request Body
{ "tasks": [ { "id": "164b640d-e192-4177-8d1b-dc440e260677", "action": "suspend" } ] }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks" } ], "tasks": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677" } ], "id": "164b640d-e192-4177-8d1b-dc440e260677", "action": "suspend", "status": "SUCCESS" } ] }
cURL Example for Returning Task Details
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677" } ], "taskId": "164b640d-e192-4177-8d1b-dc440e260677", "taskName": "userCert [ Ajay Arora ] ", "reviewer": { "links": [ { "rel": "reviewer", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/users/17" } ], "id": "17", "displayName": "Ajay Arora" }, "status": 1, "certificationInstance": { "id": "1" }, "startDate": "2019-07-02T17:05:20Z", "certificationState": "11", "percentComplete": 0 }
cURL Example for Updating a Task
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/1/tasks/164b640d-e192-4177-8d1b-dc440e260677
PUT Request Body
{ "action" : "suspend" }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677" } ], "id": "164b640d-e192-4177-8d1b-dc440e260677", "action": "suspend", "status": "SUCCESS", "fields": [ { "name": "state", "value": "SUSPENDED" }, { "name": "assignees", "value": [ "Ajay Arora" ] } ] }
cURL Example for Returning Task Line Items
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems?offset=1&limit=10" }, { "rel": "first", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems?offset=1&limit=10" } ], "count": 1, "hasMore": false, "totalResult": -1, "certLineItemList": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1" } ], "action": "1", "percentComplete": 0, "certifiedBy": "AARORA", "certifyDate": "2019-07-02T17:48:56Z", "status": "CERTIFIED", "entityId": 1, "id": 1, "createUser": "XELSYSADM", "updateDate": "2019-06-19T19:45:55Z", "updateUser": "BKIDDO", "userLogin": "BKIDDO", "firstName": "Beatrix", "lastName": "Kiddo", "roles": 2, "accounts": 0, "entitlements": 0, "employeeType": "Full-Time Employee", "identityStatus": "Active", "manager": "AARORA", "organization": "Vision", "accStatus": "false", "email": "beatrix.kiddo@vision.com", "iamUserId": 24, "fullName": "Kiddo, Beatrix" } ] }
cURL Example for Restting the Status of a Line Item
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/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems
PUT Request Body
t{ "lineItems": [ { "requestId": "100", "lineItemId": "1", "action": "ResetStatus", "comments": "test ResetStatus" }, { "requestId": "101", "lineItemId": "1", "action": "EditComment", "comments": "test EditComment" } ] }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems" } ], "lineItems": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1" } ], "action": "ResetStatus", "requestId": "100", "lineItemId": "1", "status": "SUCCESS" }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1" } ], "action": "EditComment", "requestId": "101", "lineItemId": "1", "status": "SUCCESS" } ] }
cURL Example for Returning Line Item Details
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1?offset=1&limit=10" }, { "rel": "first", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1?offset=1&limit=10" } ], "count": 2, "hasMore": false, "totalResult": -1, "lineItemDetails": [ { "id": 1, "entityId": 2, "parentEntityId": 1, "lastReviewerId": 17, "lastReviewerTaskUid": "164b640d-e192-4177-8d1b-dc440e260677", "riskSummary": 0, "itemRisk": 0, "category": "Role", "lastDecision": 5, "entityType": "USER_ROLE", "provisionedBy": 1007, "provisioningMethod": 3, "provMechRisk": 0, "requestId": { "name": "requestId", "value": "1007", "link": { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/requests/1007" } }, "openSodViolations": false, "roleId": 2, "sodRisk": 0, "userId": 1, "displayName": "Bankcard Services Lead", "name": "Bankcard Services Lead", "catalogType": "Role", "auditObjective": "SOX Compliance", "dataOwner": 7, "dataOwnerLogin": "HHANZO", "dataOwnerDisplayName": "Hattori Hanzo", "iamId": 12 }, { "id": 2, "entityId": 1, "parentEntityId": 1, "lastReviewerId": 17, "lastReviewerTaskUid": "164b640d-e192-4177-8d1b-dc440e260677", "riskSummary": 0, "itemRisk": 0, "category": "Role", "lastDecision": 5, "entityType": "USER_ROLE", "provisionedBy": 1006, "provisioningMethod": 3, "provMechRisk": 0, "requestId": { "name": "requestId", "value": "1006", "link": { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/requests/1006" } }, "openSodViolations": false, "roleId": 1, "sodRisk": 0, "userId": 1, "displayName": "Bankcard Services Analyst", "name": "Bankcard Services Analyst", "catalogType": "Role", "auditObjective": "SOX Compliance", "dataOwner": 7, "dataOwnerLogin": "HHANZO", "dataOwnerDisplayName": "Hattori Hanzo", "iamId": 13 } ] }
cURL Example for Updating a Single Line Item Action
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/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1"
PUT Request Body
{ "lineItem": { "action": "Complete", "fields": [ { "name": "comment", "value": "test complete" } ] } }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/certifications/1/tasks/164b640d-e192-4177-8d1b-dc440e260677/lineitems/1" } ], "lineItem": { "action": "Complete", "status": "SUCCESS", "lineItemId": "1" } }