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

# listApprovals

> Gateway RPC for listing pending approvals.

* Method: `listApprovals`
* Scope: `run:read`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ filter?: { runId?: string; workflow?: string; limit?: number } }`
* Response: `GatewayApprovalSummary[]`

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, and `Internal`.

Each summary includes run, workflow, node, iteration, `requestTitle`/`requestSummary`, approval mode, options, and any approval-specific allowed scopes, users, or auto-approve configuration.