sdkDeterministic

List handoffs

pipeline.listHandoffs

Read the live agent handoff queue (Scout to Researcher, Researcher to ICP, etc). Each row carries fromAgent, toAgent, status, attempts, payload, and timestamps. Stuck or failed handoffs are the #1 silent failure mode of the assembly line.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

limit

number

Max rows (1-100, default 20).

Example

TypeScripttypescript

await pipeline.listHandoffs({})

Response

The operation is available, but its typed response schema has not been published yet.

Exceptions

PipelineError: Thrown for validation, authentication, JSON-RPC, HTTP, and network failures. Inspect code and data when present.