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

# listRunDescendants

> Gateway RPC for listing a run and all of its transitive child runs.

* Method: `listRunDescendants`
* Scope: `run:read`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ runId, limit? }`
* Response: `Array<{ runId, parentRunId, depth }>`

The requested run is returned first at `depth: 0`. Direct children have `depth: 1`; grandchildren and deeper descendants follow in breadth-first depth order. `limit` defaults to 1,000 and includes the root row.

Use `listRuns` with `filter.parentRunId` when only direct children and full run summaries are needed.

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