v1

latestOpenAPI 3.0.0Proprietary2026-07-132885152.8 KB
agent

Cancel a run

Cancel an agent run that is currently queued or in progress. Once cancelled, the run will transition to a cancelled state.

Not all runs can be cancelled. Runs that are in a terminal state (SUCCEEDED, FAILED, ERROR, BLOCKED, CANCELLED) return 400. Runs in PENDING state return 409 (retry after a moment). Self-hosted, local, and GitHub Action runs return 422.

post/agent/runs/{runId}/cancel

Path parameters

runIdstring required

The unique identifier of the run to cancel

Response

Run cancelled successfully

string required

The ID of the cancelled run