Skip to main content
  • 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.