Action Certification Tasks
For the actions on certification tasks, use the following URIs:
-
/certifications GETreturns the certifications for the logged in user. -
/certifications/{certid} GETreturns the details of the certification -
/certifications/{certid}/tasks GETreturns all tasks associated with the certification -
/certification/{certid}/tasks PUTupdates all tasks associated with the certification -
/certifications/{certid}/tasks/{taskid} GETreturns the details of the given task -
/certifications/{certid}/tasks/{taskid} PUTallows the update to a task, such as expire the task, create a proxy for the task, and so on -
/certifications/{certid}/tasks/{taskid}/lineitems/ GETreturns the line items associated with the task -
/certifications/{certid/tasks/{taskid}/lineitems PUTupdates the action associated with a line item, such as claim, revoke abstain, complete, and so on -
/certifications/{certid}/tasks/{taskid}/lineitems/{lineitemid} GETreturns the details of a line item associated with a task -
/certifications/{certid}/tasks/[taskid}/lineitems/{linieitemid} PUTupdates 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"
}
}