Delete process instance
POST/process-instances/:processInstanceKey/deletion
Eventually Consistent About endpoint data consistency
Learn about endpoint consistencyDeletes a process instance. Only instances that are completed or terminated can be deleted.
Request
Responses
- 204
- 401
- 403
- 404
- 409
- 500
- 503
The process instance will be deleted.
The request lacks valid authentication credentials.
Response Headers
Forbidden. The request is not allowed.
The process instance is not found.
The process instance is not in a completed or terminated state and cannot be deleted.
An internal error occurred while processing the request.
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 .