Delete process instanceAdded in 8.9

POST 
/process-instances/:processInstanceKey/deletion

Strongly Consistent About endpoint data consistency

Deletes a process instance. Only instances that are completed or terminated can be deleted.

Required permissions

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

Resource type	Permission
PROCESS_DEFINITION	DELETE_PROCESS_INSTANCE

Request

Responses

204

The process instance is marked for deletion.

401

The request lacks valid authentication credentials.

Response Headers

WWW-Authenticate

403

Forbidden. The request is not allowed.

404

The process instance is not found.

409

The process instance is not in a completed or terminated state and cannot be deleted.

500

An internal error occurred while processing the request.

503

The service is currently unavailable. This may happen only on some requests where the system creates backpressure to prevent the server's compute resources from being exhausted, avoiding more severe failures. In this case, the title of the error object contains RESOURCE_EXHAUSTED. Clients are recommended to eventually retry those requests after a backoff period. You can learn more about the backpressure mechanism here: https://docs.camunda.io/docs/components/zeebe/technical-concepts/internal-processing/#handling-backpressure .