Initiate Bulk Binder User Actions

For each bulk action, you may only select a single workflow that Vault will start for all selected and valid binders.

PUT/api/{version}/objects/binders/lifecycle_actions/{user_action_name}

Headers

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

URI Path Parameters

Name	Description
`{user_action_name}`	The user action `name__v` field value. Find this value with the Retrieve User Actions on Multiple Binders endpoint.

Body Parameters

Name	Description
`docIds` required	Include a comma-separated list of binder IDs and major and minor version numbers. For example, `222:0:1,223:0:1,224:0:1` specifies version 0.1 of binder IDs 222, 223, and 224. The user action is only executed on binder IDs in the `lifecycle` and `state` specified in the request body. Binder IDs listed in this parameter which are not in the specified `lifecycle` and `state` are skipped.
`lifecycle` required	Include the name of the binder lifecycle.
`state` required	Include the current state of your binder.

Request Details

In this request:

The input file format is set to accept name-value pairs.
The lifecycle is specified. These documents are assigned to the general_lifecycle__c.
The state is specified. We're changing the state of all four binders from draft to approved.

Request

curl -X PUT -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "docIds=222:0:1,223:0:1,224:0:1,225:0:1" \
-d "lifecycle=general_lifecycle__c" \
-d "state=draft__c" \
https://myvault.veevavault.com/api/v25.1/objects/documents/lifecycle_actions/approve__c

Response

{
  "responseStatus": "SUCCESS"
}

Response Details

On SUCCESS, the initiating user receives a summary email detailing which binders succeeded and failed the requested action.