GEgetaxonflow
Unified Executions

Cancel a unified execution

Cancels a running MAP plan or WCP workflow through the unified API. The cancellation propagates to the owning subsystem (plan cancel or workflow abort). Cancelling an execution already in a terminal state returns 409.

post/api/v1/unified/executions/{id}/cancel

Request

Path parameters

idstring required

Execution id (or plan_/wf_/wcp_ prefixed subsystem id)

Headers

X-Tenant-IDstring required

Tenant identifier scoping the request. The AxonFlow Agent gateway sets this header after authentication; the orchestrator fails closed when it is absent (401 on audit/decision endpoints, 400 on others — see each operation). Clients cannot widen their scope through it: handlers force the tenant filter from this header, never from the request body.

X-Org-IDstring required

Organization identifier for scoping results

Request body

reasonstring

Cancellation reason (defaults to "cancelled via unified API")

Response

Execution cancelled; returns the refreshed unified status record (or a {execution_id, status: "cancelled", message} fallback if the post-cancel re-read fails).

execution_idstring
execution_type'map_plan' | 'wcp_workflow'
namestring
sourcestring
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'aborted' | 'expired'
current_step_indexinteger
total_stepsinteger
progress_percentnumber double
started_atstring date-time
completed_atstring date-time
durationstring
estimated_cost_usdnumber double
actual_cost_usdnumber double
errorstring
tenant_idstring
org_idstring
user_idstring
client_idstring
metadataobject
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.