POST/api/v2/executions/{id}/cancel
Headers
Authorizationstring requiredBearer pj_live_… Raw keys are shown only when created. The
x-api-keyheader is an alternative transport.Key scope:
execution:cancel.
Path parameters
idstring (uuid) required
Response 200
200 OK Queued execution was cancelled, or cancellation was already terminal.
schema_versionconst "execution-cancellation.v1" requiredexecution_idstring (uuid) requiredstatusenum requiredcancellingcancelleddispositionenum requiredcancelledcancellation_requestedalready_cancelledalready_requestedstatus_revisioninteger requiredcancel_requested_atstring (date-time) requiredterminal_atstring,null required
Response 202
202 Accepted Running execution entered cancelling; its worker owns terminal settlement.
schema_versionconst "execution-cancellation.v1" requiredexecution_idstring (uuid) requiredstatusenum requiredcancellingcancelleddispositionenum requiredcancelledcancellation_requestedalready_cancelledalready_requestedstatus_revisioninteger requiredcancel_requested_atstring (date-time) requiredterminal_atstring,null required
Errors
| Status | When |
|---|---|
401 | Missing, invalid, unentitled, or no-longer-accepted API key. |
403 | The key lacks the required execution scope. |
404 | The organization/environment-scoped resource was not found. |
409 | The execution is already terminal as succeeded, failed, or blocked and is never overwritten by cancellation. |
503 | Launch control is held or execution authority is unavailable. |
curl -X POST \
-H "Authorization: Bearer pj_live_YOUR_KEY" \
https://runstamp.com/api/v2/executions/8f4fa0a3-f907-41f5-babe-5762f974cb83/cancelResponse 200 OK
{
"schema_version": "execution-cancellation.v1",
"execution_id": "8f4fa0a3-f907-41f5-babe-5762f974cb83",
"status": "cancelling",
"disposition": "cancelled",
"status_revision": 1,
"cancel_requested_at": "2026-10-12T09:30:00.000Z",
"terminal_at": {}
}