Reassign Multi-item Workflow Task

Reassign an open workflow task to another user for a multi-item workflow.

You cannot reassign a task to a user who is already assigned to that specific task, has completed that task, or is configured with a restricted role. However, you can reassign a user to continuing iterations of the same task if an Admin has enabled users in the workflow to only complete one task.

POST/api/{version}/objects/objectworkflows/tasks/{task_id}/actions/mdwreassign

Headers

Name	Description
`Content-Type`	`application/json` or `application/x-www-form-urlencoded`
`Accept`	`application/json` (default) or `application/xml`

URI Path Parameters

Name	Description
`{task_id}`	The `id` of the task to reassign.

Body Parameters

Name	Description
`task_assignee__v` required	The `id` of the user who will become the new task assignee, in the format `user:{id}`. For example, `user:100307`.

Request

curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d 'task_assignee__v=user:2135709'
https://myvault.veevavault.com/api/v26.1/objects/objectworkflows/tasks/9626/actions/mdwreassign

Response

{
    "responseStatus": "SUCCESS"
}

Response Details

Returns SUCCESS if the task was successfully reassigned. Vault notifies the new task owner and the previous task owner of the reassignment.