Agents / TypeScript SDK
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.
pipeline.listHandoffsDeterministic operationParameters
workspaceIdOptional · string- Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
limitOptional · number- Max rows (1-100, default 20).
await pipeline.listHandoffs({})Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1,
"description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
},
"limit": {
"type": "number",
"description": "Max rows (1-100, default 20)."
}
}
}