Initiate Workflow Actions on Multiple Workflows

Use this request to initiate a workflow action on multiple workflows. This starts an asynchronous job whose status you can check with the Retrieve Job Status endpoint. Maximum 500 workflows per request.

POST/api/{version}/object/workflow/actions/{action}

Headers

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

URI Path Parameters

Name	Description
`action`	The `name` of the workflow action. To get this value, Retrieve Bulk Workflow Actions.

Body Parameters

In the body of the request, add any fields required to initiate the action. To find which fields are required for an action, Retrieve Bulk Workflow Action Details.

Cancel Active Workflows: cancelworkflows

Name	Description
`workflow_ids`	Input a comma-separated list of `workflow_id__v` field values. Maximum 500 workflows.

Reassign Workflow Tasks: reassigntasks

Note that this action can reassign a maximum of 500 tasks.

Name	Description
`current_task_assignee`	Input the user ID of the user whose tasks you wish to reassign. You cannot reassign specific tasks for a user, only all tasks currently assigned to a user.
`new_task_assignee`	Input the user ID of the user who will receive the newly assigned tasks.

Cancel Workflow Tasks: canceltasks

When cancelling tasks, you can do so by user ID or task ID. Use one of the following parameters:

Name	Description
`user_ids`	To cancel tasks by user ID, input a comma-separated list of the user IDs for the users whose tasks you wish to cancel. You cannot cancel specific tasks for a user, only all tasks currently assigned to a user. Maximum 100 user IDs per request.
`task_ids`	To cancel tasks by task ID, input a comma-separated list of the task IDs to cancel. You cannot cancel task IDs for a specific user, only all instances of the given task IDs.

Replace Workflow Owner: replaceworkflowowner

Name	Description
`new_workflow_owner__v`	Input the ID of the user who will become the new workflow owner.

Request

curl -L -X POST -H "Authorization: {SESSION_ID}" \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'workflow_ids=2903,2904,2905' \
https://myvault.veevavault.com/api/v21.2/object/workflow/actions/cancelworkflows

Response

{
   "responseStatus": "SUCCESS",
   "data": {
       "job_id": 93601
   }
}

Response Details

On SUCCESS, the response returns the job_id for the action, and the authenticated user will receive an email notification with details of any failures that occur.