Skip to navigation

Delete an execution

View as Markdown

Delete an execution and everything retrieved under it.

This is a purge, not an archive: the execution, its state, its records and its attachments are removed and cannot be recovered. Call it as soon as you have stored what you need — the fastest way to protect somebody’s financial data is not to be holding it.

Irreversible, and it takes the data with it. After this call the id answers 404 exactly like one that never existed — not a deleted marker, not an empty result. Read the results first.

StatusMeaning
204Gone. No body.
404No such execution for your application, or it was already deleted.
409It is still running. Only a closed execution can be deleted — stop it first, or wait for the ended event.

Executions you never delete are removed on their own after the platform’s retention period, but that is a safety net rather than a policy: data minimisation is yours to drive, and this is the call that drives it.

Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"
The execution, as the acceptance response returned it.

Response

204 No Content
Gone — the execution, its state and the records it retrieved. From here on the id answers 404 exactly like one that never existed. No body.

Errors

404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error