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/v68.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}