Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-224341,4072.0 MB
Task

Reassign

Reassign a task's current policy step to a different set of users. The target step must be an approval, provision, or form step.

post/api/v1/tasks/{task_id}/action/reassign

Path parameters

task_idstring required

The ID of the task to reassign.

Request body

commentstring

An optional comment attached to the reassignment.

newStepUserIdsstring[] nullable

The IDs of the users to reassign the current policy step to. Must be from the allowed reassignees list.

policyStepIdstring

The ID of the current policy step to reassign. Must match the task's active step.

Response

The TaskActionsServiceReassignResponse returns a task view with paths indicating the location of expanded items in the array.

ticketActionIdstring

The ID of the task reassign action created by this request.