Modify process instances (batch)Added in 8.8

POST 
/process-instances/modification

Strongly Consistent About endpoint data consistency

Modify multiple process instances. Only ACTIVE process instances are modified. The given filter only narrows the batch. In contrast to single modification operation, it is not possible to add variable instructions or modify by element key. It is only possible to use the element id of the source and target. This is done asynchronously, the progress can be tracked using the batchOperationKey from the response and the batch operation status endpoint (/batch-operations/{batchOperationKey}).

Required permissions

When authorization is enabled, this endpoint requires the following permission. See resources and permissions to learn more.

Resource type	Permission
BATCH	CREATE or CREATE_BATCH_OPERATION_MODIFY_PROCESS_INSTANCE

Request

Responses

200

The batch operation request was created.

400

The process instance batch operation failed, for example because the filter requests a top-level state other than ACTIVE through $eq or $in. States inside $or branches are not validated. More details are provided in the response body.

401

The request lacks valid authentication credentials.

Response Headers

WWW-Authenticate

403

Forbidden. The request is not allowed.

500

An internal error occurred while processing the request.