Reassign Approval Work Item Action
Reassign an approval work item that hasn't been completed. You can
also add comments about why the approval admin reassigned the approval work
item.
This action also validates if a user has required permissions to reassign an approval work item and update the assignee. Keep these considerations in mind when you use this invocable action.
- The user must have the Approval Admin user permission.
- The status of the approval work item must be in Assigned status.
This action is available in API version 62.0 and later.
Supported REST HTTP Methods
URI: /services/data/v66.0/actions/standard/reassignApprovalWorkItem
Formats: JSON, XML
HTTP Methods: POST
Authentication: Authorization: Bearer token
Inputs
| Input | Type | Description |
|---|---|---|
| approvalWorkItemId | string | Required. ID of the approval work item to be reassigned. |
| assigneeId | string | Required. ID of the user, group, or queue to reassign the approval work item to. |
| comments | string | Comments entered by the approval admin about why they reassigned the approval work item. |
Outputs
None.
Example
POST
Here's a sample request for the Reassign Approval Work Item action.
1{
2 "inputs": [
3 {
4 "approvalWorkItemId": "9jRDU00000015C22AI",
5 "assigneeId": "005DU000000I3zHYAS",
6 "comments": "Needs to be reviewed."
7 }
8 ]
9}Here's a sample response for the Reassign Approval Work Item action.
1{
2 "actionName": "reassignApprovalWorkItem",
3 "errors": null,
4 "invocationId": null,
5 "isSuccess": true,
6 "outcome": null,
7 "outputValues": null,
8 "sortOrder": -1,
9 "version": 1
10}