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

# pauseRun

> Gateway RPC for gracefully pausing an active run.

`pauseRun` gracefully pauses an active run: the engine stops scheduling new
tasks, lets in-flight tasks finish, then parks the run in the resumable `paused`
status. Unlike `cancelRun`, it never aborts running tasks. Resume with
`resumeRun` (or `bunx smithers-orchestrator up --resume`).

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

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `RunNotFound`, `RUN_NOT_ACTIVE`, and `Internal`. `RUN_NOT_ACTIVE` means the run is not currently executing (only a live `running` run can be gracefully paused). Returns `Forbidden` if the caller lacks `run:write` scope.