> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# cancelRun

> Gateway RPC for cancelling an active run.

`cancelRun` requests cancellation of an active run.

* Method: `cancelRun`
* Scope: `run:write`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ runId }`
* Response: `{ runId, status: "cancelling" }`

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `RUN_NOT_ACTIVE`, and `Internal`. `RUN_NOT_ACTIVE` means the run is not currently active, including already-finished runs; `Forbidden` means the caller lacks `run:write` scope.