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

# rewindRun

> Gateway RPC for rewinding a run to a frame.

* Method: `rewindRun`
* Scope: `run:admin`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ runId, frameNo, confirm: true, force?, noRevert? }`
* Response: `JumpResult`, including an unconditional `effectBoundary` report with `blocking`, `revertible`, and `warnings` arrays

`force` crosses unresolved effects and marks the run needs-attention. `noRevert`
skips registered compensation handlers, so those effects require `force`.

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `RunNotFound`, `FrameOutOfRange`, `Busy`, `RateLimited`, `UnsupportedSandbox`, `VcsError`, `RewindFailed`, and `TIME_TRAVEL_SIDE_EFFECT_BLOCKED`.