Cancel an execution
Cancels a pending or running execution. If the execution is already in a terminal state (completed, failed, cancelled), this is a no-op and the current execution is returned.
BearerAuthAuthorizationBearer <JWT>Admin token, API token issued via /api-tokens, or an OIDC JWT access token issued by the configured OIDC provider.
flow*stringuuidexecution*stringuuidThe execution after cancellation.
application/json- response
name*stringUnique resource name
status*stringCurrent execution status. Known values: pending, running, completed, failed, cancelled. Clients should handle unknown values gracefully.
stdout*stringCaptured standard output.
stderr*stringCaptured standard error.
exitCode*integerProcess exit code. 0 indicates success.
duration*stringWall-clock duration
createTime*stringTime at which the execution was created.
date-timetracePath?stringObject-store key of the .trace artifact, empty unless the run was started with trace: true and produced one. Download the bytes with GET /flows/{flow}/executions/{execution}/trace.
files?array<>Files uploaded to this execution via POST :upload. Populated by GET /flows/{flow}/executions/{execution} (owner or admin only); omitted from list responses to keep them lightweight.
curl -X POST 'https://example.com/api/hub/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08/executions/497f6eca-6276-4993-bfeb-53cbbbba6f08:cancel'{ "name": "flows/550e8400-e29b-41d4-a716-446655440000/executions/660e8400-e29b-41d4-a716-446655440000", "status": "completed", "stdout": "string", "stderr": "string", "exitCode": 0, "duration": "3.5s", "createTime": "2019-08-24T14:15:22Z", "tracePath": "executions/660e8400-e29b-41d4-a716-446655440000/trace", "files": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "filename": "string", "uploadedBy": "1e2815fd-75c7-4289-86d5-2503daeb59b8", "createTime": "2019-08-24T14:15:22Z" } ]}