cliDeterministic

List handoffs

pipeline list-handoffs

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

CLI commandbash

pipeline list-handoffs

Response

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

Exit codes

1: Invalid input or local configuration.
2: The API or tool returned an error.
3: Authentication failed.
4: A network request failed.