Action Provisioning Tasks or Fulfillment Tasks
The user can take actions of provisioning/fulfilment using the following URIs:
-
/provtasks GET
: Obtains the provisioning tasks for the user with the appropriate filter -
/provtasks PUT
: Allows for the update of multiple tasks -
/provtasks/{taskid} PUT
: Allows for the update of a single task
cURL Example for Obtaining the Provisioning Tasks for the User with the Appropriate Filter
curl -H "Content-Type: application/json" -X GET -u username:password https://pseudo.com/iam/governance/selfservice/api/v1/provtasks?q=Status.Category+eq+Rejected
GET Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks" }, { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks?offset=1&limit=10&q=Status.Category%20eq%20Rejected" }, { "rel": "first", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks?offset=1&limit=10&q=Status.Category%20eq%20Rejected" } ], "count": 5, "hasMore": false, "totalResult": -1, "tasks": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/1006" } ], "fields": [ { "name": "Process Instance.Descriptive Data", "value": "dtran20190614c" }, { "name": "Process Instance.Task Information.Assign Type", "value": "User" }, { "name": "Process.Process Definition.Process Form Key", "value": 11 }, { "name": "Groups.Group Name", "value": "" }, { "name": "Objects.Key", "value": 6 }, { "name": "Status.Category", "value": "Rejected" }, { "name": "Process Instance.Task Information.Target User Last Name", "value": "dtran20190614" }, { "name": "Objects.Type", "value": "Application" }, { "name": "Process Instance.Task Information.Assigned To Group Key", "value": 0 }, { "name": "Process Instance.Task Information.Target User", "value": "DTRAN20190614" }, { "name": "Process Instance.Task Information.Assignee Last Name", "value": "Administrator" }, { "name": "APP_INSTANCE_NAME", "value": "VisionEmployeesDomain" }, { "name": "REQUEST_KEY", "value": 0 }, { "name": "Process Instance.Task Information.Assignee User Key", "value": 1 }, { "name": "Process Instance.Task Information.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Action", "value": "" }, { "name": "Process Instance.Task Details.Creation Date", "value": "June 17, 2019 04:52:14 PM" }, { "name": "INSTANCE_KEY", "value": 23 }, { "name": "Process Instance.Task Details.Key", "value": 1006 }, { "name": "Process Instance.Task Information.Assigned To User Key", "value": 1 }, { "name": "Process Instance.Task Information.Updated By", "value": 83 }, { "name": "Process Definition.Tasks.Key", "value": 58 }, { "name": "Process Instance.Task Information.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected Start", "value": "June 17, 2019 04:52:14 PM" }, { "name": "Process Instance.Task Details.Actual Start Date", "value": "June 17, 2019 04:52:14 PM" }, { "name": "Process Instance.Task Details.Type", "value": "" }, { "name": "Process Instance.Task Information.Assignee First Name", "value": "System" }, { "name": "Process Instance.Task Details.Status", "value": "R" }, { "name": "Process Instance.Task Details.Updated By", "value": 83 }, { "name": "APP_INSTANCE_KEY", "value": 1 }, { "name": "Process Instance.Task Information.Creation Date", "value": "June 17, 2019 04:52:14 PM" }, { "name": "Process Instance.Task Information.Retry Task", "value": 0 }, { "name": "Process Instance.Task Details.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected End", "value": "June 17, 2019 04:52:14 PM" }, { "name": "Process Instance.Task Details.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Update Date", "value": "June 17, 2019 04:52:15 PM" }, { "name": "Process Instance.Task Details.Data", "value": "" }, { "name": "Process Definition.Tasks.Task Name", "value": "Create User" }, { "name": "Process Instance.Task Information.Target User First Name", "value": "" }, { "name": "Process Instance.Task Details.Actual End Date", "value": "January 01, 1970 12:00:00 AM" }, { "name": "Process Instance.Task Information.Update Date", "value": "June 17, 2019 04:52:15 PM" }, { "name": "Process Instance.Task Information.Assignee User ID", "value": "XELSYSADM" }, { "name": "Process Instance.Task Information.Assigned Date", "value": "June 17, 2019 04:52:14 PM" }, { "name": "Process Instance.Task Information.Assigned To", "value": 0 }, { "name": "Process Instance.Key", "value": 223 }, { "name": "Process Instance.Task Details.Task Offlined", "value": 0 }, { "name": "RNUM", "value": 1 }, { "name": "Groups.Key", "value": 0 }, { "name": "Organizations.Organization Name", "value": "Vision" }, { "name": "Objects.Name", "value": "AD User" } ] }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/1002" } ], "fields": [ { "name": "Process Instance.Descriptive Data", "value": "dtran20190614a" }, { "name": "Process Instance.Task Information.Assign Type", "value": "User" }, { "name": "Process.Process Definition.Process Form Key", "value": 11 }, { "name": "Groups.Group Name", "value": "" }, { "name": "Objects.Key", "value": 6 }, { "name": "Status.Category", "value": "Rejected" }, { "name": "Process Instance.Task Information.Target User Last Name", "value": "dtran20190614" }, { "name": "Objects.Type", "value": "Application" }, { "name": "Process Instance.Task Information.Assigned To Group Key", "value": 0 }, { "name": "Process Instance.Task Information.Target User", "value": "DTRAN20190614" }, { "name": "Process Instance.Task Information.Assignee Last Name", "value": "Administrator" }, { "name": "APP_INSTANCE_NAME", "value": "VisionEmployeesDomain" }, { "name": "REQUEST_KEY", "value": 0 }, { "name": "Process Instance.Task Information.Assignee User Key", "value": 1 }, { "name": "Process Instance.Task Information.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Action", "value": "" }, { "name": "Process Instance.Task Details.Creation Date", "value": "June 17, 2019 04:47:15 PM" }, { "name": "INSTANCE_KEY", "value": 21 }, { "name": "Process Instance.Task Details.Key", "value": 1002 }, { "name": "Process Instance.Task Information.Assigned To User Key", "value": 1 }, { "name": "Process Instance.Task Information.Updated By", "value": 83 }, { "name": "Process Definition.Tasks.Key", "value": 58 }, { "name": "Process Instance.Task Information.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected Start", "value": "June 17, 2019 04:47:15 PM" }, { "name": "Process Instance.Task Details.Actual Start Date", "value": "June 17, 2019 04:47:15 PM" }, { "name": "Process Instance.Task Details.Type", "value": "" }, { "name": "Process Instance.Task Information.Assignee First Name", "value": "System" }, { "name": "Process Instance.Task Details.Status", "value": "R" }, { "name": "Process Instance.Task Details.Updated By", "value": 83 }, { "name": "APP_INSTANCE_KEY", "value": 1 }, { "name": "Process Instance.Task Information.Creation Date", "value": "June 17, 2019 04:47:15 PM" }, { "name": "Process Instance.Task Information.Retry Task", "value": 0 }, { "name": "Process Instance.Task Details.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected End", "value": "June 17, 2019 04:47:15 PM" }, { "name": "Process Instance.Task Details.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Update Date", "value": "June 17, 2019 04:47:17 PM" }, { "name": "Process Instance.Task Details.Data", "value": "" }, { "name": "Process Definition.Tasks.Task Name", "value": "Create User" }, { "name": "Process Instance.Task Information.Target User First Name", "value": "" }, { "name": "Process Instance.Task Details.Actual End Date", "value": "January 01, 1970 12:00:00 AM" }, { "name": "Process Instance.Task Information.Update Date", "value": "June 17, 2019 04:47:17 PM" }, { "name": "Process Instance.Task Information.Assignee User ID", "value": "XELSYSADM" }, { "name": "Process Instance.Task Information.Assigned Date", "value": "June 17, 2019 04:47:15 PM" }, { "name": "Process Instance.Task Information.Assigned To", "value": 0 }, { "name": "Process Instance.Key", "value": 221 }, { "name": "Process Instance.Task Details.Task Offlined", "value": 0 }, { "name": "RNUM", "value": 2 }, { "name": "Groups.Key", "value": 0 }, { "name": "Organizations.Organization Name", "value": "Vision" }, { "name": "Objects.Name", "value": "AD User" } ] }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/1004" } ], "fields": [ { "name": "Process Instance.Descriptive Data", "value": "dtran20190614b" }, { "name": "Process Instance.Task Information.Assign Type", "value": "User" }, { "name": "Process.Process Definition.Process Form Key", "value": 11 }, { "name": "Groups.Group Name", "value": "" }, { "name": "Objects.Key", "value": 6 }, { "name": "Status.Category", "value": "Rejected" }, { "name": "Process Instance.Task Information.Target User Last Name", "value": "dtran20190614" }, { "name": "Objects.Type", "value": "Application" }, { "name": "Process Instance.Task Information.Assigned To Group Key", "value": 0 }, { "name": "Process Instance.Task Information.Target User", "value": "DTRAN20190614" }, { "name": "Process Instance.Task Information.Assignee Last Name", "value": "Administrator" }, { "name": "APP_INSTANCE_NAME", "value": "VisionEmployeesDomain" }, { "name": "REQUEST_KEY", "value": 0 }, { "name": "Process Instance.Task Information.Assignee User Key", "value": 1 }, { "name": "Process Instance.Task Information.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Action", "value": "" }, { "name": "Process Instance.Task Details.Creation Date", "value": "June 17, 2019 04:50:25 PM" }, { "name": "INSTANCE_KEY", "value": 22 }, { "name": "Process Instance.Task Details.Key", "value": 1004 }, { "name": "Process Instance.Task Information.Assigned To User Key", "value": 1 }, { "name": "Process Instance.Task Information.Updated By", "value": 83 }, { "name": "Process Definition.Tasks.Key", "value": 58 }, { "name": "Process Instance.Task Information.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected Start", "value": "June 17, 2019 04:50:25 PM" }, { "name": "Process Instance.Task Details.Actual Start Date", "value": "June 17, 2019 04:50:25 PM" }, { "name": "Process Instance.Task Details.Type", "value": "" }, { "name": "Process Instance.Task Information.Assignee First Name", "value": "System" }, { "name": "Process Instance.Task Details.Status", "value": "R" }, { "name": "Process Instance.Task Details.Updated By", "value": 83 }, { "name": "APP_INSTANCE_KEY", "value": 1 }, { "name": "Process Instance.Task Information.Creation Date", "value": "June 17, 2019 04:50:25 PM" }, { "name": "Process Instance.Task Information.Retry Task", "value": 0 }, { "name": "Process Instance.Task Details.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected End", "value": "June 17, 2019 04:50:25 PM" }, { "name": "Process Instance.Task Details.Created By", "value": 83 }, { "name": "Process Instance.Task Details.Update Date", "value": "June 17, 2019 04:50:26 PM" }, { "name": "Process Instance.Task Details.Data", "value": "" }, { "name": "Process Definition.Tasks.Task Name", "value": "Create User" }, { "name": "Process Instance.Task Information.Target User First Name", "value": "" }, { "name": "Process Instance.Task Details.Actual End Date", "value": "January 01, 1970 12:00:00 AM" }, { "name": "Process Instance.Task Information.Update Date", "value": "June 17, 2019 04:50:26 PM" }, { "name": "Process Instance.Task Information.Assignee User ID", "value": "XELSYSADM" }, { "name": "Process Instance.Task Information.Assigned Date", "value": "June 17, 2019 04:50:25 PM" }, { "name": "Process Instance.Task Information.Assigned To", "value": 0 }, { "name": "Process Instance.Key", "value": 222 }, { "name": "Process Instance.Task Details.Task Offlined", "value": 0 }, { "name": "RNUM", "value": 3 }, { "name": "Groups.Key", "value": 0 }, { "name": "Organizations.Organization Name", "value": "Vision" }, { "name": "Objects.Name", "value": "AD User" } ] }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/1008" } ], "fields": [ { "name": "Process Instance.Descriptive Data", "value": "dtran20190614a" }, { "name": "Process Instance.Task Information.Assign Type", "value": "User" }, { "name": "Process.Process Definition.Process Form Key", "value": 11 }, { "name": "Groups.Group Name", "value": "" }, { "name": "Objects.Key", "value": 6 }, { "name": "Status.Category", "value": "Rejected" }, { "name": "Process Instance.Task Information.Target User Last Name", "value": "dtran20190614" }, { "name": "Objects.Type", "value": "Application" }, { "name": "Process Instance.Task Information.Assigned To Group Key", "value": 0 }, { "name": "Process Instance.Task Information.Target User", "value": "DTRAN20190614" }, { "name": "Process Instance.Task Information.Assignee Last Name", "value": "Administrator" }, { "name": "APP_INSTANCE_NAME", "value": "VisionEmployeesDomain" }, { "name": "REQUEST_KEY", "value": 0 }, { "name": "Process Instance.Task Information.Assignee User Key", "value": 1 }, { "name": "Process Instance.Task Information.Created By", "value": 4 }, { "name": "Process Instance.Task Details.Action", "value": "" }, { "name": "Process Instance.Task Details.Creation Date", "value": "June 17, 2019 05:36:32 PM" }, { "name": "INSTANCE_KEY", "value": 21 }, { "name": "Process Instance.Task Details.Key", "value": 1008 }, { "name": "Process Instance.Task Information.Assigned To User Key", "value": 1 }, { "name": "Process Instance.Task Information.Updated By", "value": 4 }, { "name": "Process Definition.Tasks.Key", "value": 61 }, { "name": "Process Instance.Task Information.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected Start", "value": "June 17, 2019 05:36:32 PM" }, { "name": "Process Instance.Task Details.Actual Start Date", "value": "June 17, 2019 05:36:32 PM" }, { "name": "Process Instance.Task Details.Type", "value": "" }, { "name": "Process Instance.Task Information.Assignee First Name", "value": "System" }, { "name": "Process Instance.Task Details.Status", "value": "R" }, { "name": "Process Instance.Task Details.Updated By", "value": 4 }, { "name": "APP_INSTANCE_KEY", "value": 1 }, { "name": "Process Instance.Task Information.Creation Date", "value": "June 17, 2019 05:36:32 PM" }, { "name": "Process Instance.Task Information.Retry Task", "value": 0 }, { "name": "Process Instance.Task Details.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected End", "value": "June 17, 2019 05:36:32 PM" }, { "name": "Process Instance.Task Details.Created By", "value": 4 }, { "name": "Process Instance.Task Details.Update Date", "value": "June 17, 2019 05:36:33 PM" }, { "name": "Process Instance.Task Details.Data", "value": "" }, { "name": "Process Definition.Tasks.Task Name", "value": "Disable User" }, { "name": "Process Instance.Task Information.Target User First Name", "value": "" }, { "name": "Process Instance.Task Details.Actual End Date", "value": "January 01, 1970 12:00:00 AM" }, { "name": "Process Instance.Task Information.Update Date", "value": "June 17, 2019 05:36:33 PM" }, { "name": "Process Instance.Task Information.Assignee User ID", "value": "XELSYSADM" }, { "name": "Process Instance.Task Information.Assigned Date", "value": "June 17, 2019 05:36:32 PM" }, { "name": "Process Instance.Task Information.Assigned To", "value": 0 }, { "name": "Process Instance.Key", "value": 221 }, { "name": "Process Instance.Task Details.Task Offlined", "value": 0 }, { "name": "RNUM", "value": 4 }, { "name": "Groups.Key", "value": 0 }, { "name": "Organizations.Organization Name", "value": "Vision" }, { "name": "Objects.Name", "value": "AD User" } ] }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/1010" } ], "fields": [ { "name": "Process Instance.Descriptive Data", "value": "dtran20190614b" }, { "name": "Process Instance.Task Information.Assign Type", "value": "User" }, { "name": "Process.Process Definition.Process Form Key", "value": 11 }, { "name": "Groups.Group Name", "value": "" }, { "name": "Objects.Key", "value": 6 }, { "name": "Status.Category", "value": "Rejected" }, { "name": "Process Instance.Task Information.Target User Last Name", "value": "dtran20190614" }, { "name": "Objects.Type", "value": "Application" }, { "name": "Process Instance.Task Information.Assigned To Group Key", "value": 0 }, { "name": "Process Instance.Task Information.Target User", "value": "DTRAN20190614" }, { "name": "Process Instance.Task Information.Assignee Last Name", "value": "Administrator" }, { "name": "APP_INSTANCE_NAME", "value": "VisionEmployeesDomain" }, { "name": "REQUEST_KEY", "value": 0 }, { "name": "Process Instance.Task Information.Assignee User Key", "value": 1 }, { "name": "Process Instance.Task Information.Created By", "value": 4 }, { "name": "Process Instance.Task Details.Action", "value": "" }, { "name": "Process Instance.Task Details.Creation Date", "value": "June 17, 2019 05:36:34 PM" }, { "name": "INSTANCE_KEY", "value": 22 }, { "name": "Process Instance.Task Details.Key", "value": 1010 }, { "name": "Process Instance.Task Information.Assigned To User Key", "value": 1 }, { "name": "Process Instance.Task Information.Updated By", "value": 4 }, { "name": "Process Definition.Tasks.Key", "value": 61 }, { "name": "Process Instance.Task Information.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected Start", "value": "June 17, 2019 05:36:34 PM" }, { "name": "Process Instance.Task Details.Actual Start Date", "value": "June 17, 2019 05:36:34 PM" }, { "name": "Process Instance.Task Details.Type", "value": "" }, { "name": "Process Instance.Task Information.Assignee First Name", "value": "System" }, { "name": "Process Instance.Task Details.Status", "value": "R" }, { "name": "Process Instance.Task Details.Updated By", "value": 4 }, { "name": "APP_INSTANCE_KEY", "value": 1 }, { "name": "Process Instance.Task Information.Creation Date", "value": "June 17, 2019 05:36:34 PM" }, { "name": "Process Instance.Task Information.Retry Task", "value": 0 }, { "name": "Process Instance.Task Details.Row Version", "value": "AAAAAAAAAAE=" }, { "name": "Process Instance.Task Details.Projected End", "value": "June 17, 2019 05:36:34 PM" }, { "name": "Process Instance.Task Details.Created By", "value": 4 }, { "name": "Process Instance.Task Details.Update Date", "value": "June 17, 2019 05:36:35 PM" }, { "name": "Process Instance.Task Details.Data", "value": "" }, { "name": "Process Definition.Tasks.Task Name", "value": "Disable User" }, { "name": "Process Instance.Task Information.Target User First Name", "value": "" }, { "name": "Process Instance.Task Details.Actual End Date", "value": "January 01, 1970 12:00:00 AM" }, { "name": "Process Instance.Task Information.Update Date", "value": "June 17, 2019 05:36:35 PM" }, { "name": "Process Instance.Task Information.Assignee User ID", "value": "XELSYSADM" }, { "name": "Process Instance.Task Information.Assigned Date", "value": "June 17, 2019 05:36:34 PM" }, { "name": "Process Instance.Task Information.Assigned To", "value": 0 }, { "name": "Process Instance.Key", "value": 222 }, { "name": "Process Instance.Task Details.Task Offlined", "value": 0 }, { "name": "RNUM", "value": 5 }, { "name": "Groups.Key", "value": 0 }, { "name": "Organizations.Organization Name", "value": "Vision" }, { "name": "Objects.Name", "value": "AD User" } ] } ] }
cURL Example for Updating Multiple Tasks
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/provtasks
PUT Request Body
{ "tasks":[ { "id" : "3016", "requestId" : "10001", "action": "reassign", "fields": [ { "name": "assignee", "value": "23" }, { "name": "type", "value": "user" } ] }, { "id" : "3018", "requestId" : "10002", "action": "reassign", "fields": [ { "name": "assignee", "value": "23" }, { "name": "type", "value": "user" } ] } ] }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks" } ], "tasks": [ { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/3018" } ], "id": "3018", "status": "SUCCESS", "requestId": "10002", "action": "reassign" }, { "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/3016" } ], "id": "3016", "status": "SUCCESS", "requestId": "10001", "action": "reassign" } ] }
cURL Example for Updating a Single 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/provtasks/3009
PUT Request Body
{ "action": "reassign", "fields": [ { "name": "assignee", "value": "23" }, { "name": "type", "value": "user" } ] }
PUT Response Body
{ "links": [ { "rel": "self", "href": "https://pseudo.com/iam/governance/selfservice/api/v1/provtasks/3009" } ], "id": "3009", "status": "SUCCESS" }