Cancel Run

Cancel an active workflow run. Immediately marks the run as `cancelled` and stops any further processing. In-flight work at the current node may be abandoned mid-execution. The operation is idempotent: cancelling an already-cancelled run returns the run unchanged without error. Only runs in `pending`, `running`, or `paused` status can be cancelled. Runs that have already reached a terminal state (`completed`, `failed`, `cancelled`) return 409. Unlike `pause`, cancel is permanent — a cancelled run cannot be resumed. Use `pause` if you intend to continue the run later.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"
run_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error