List an agent's handoff events
Agents
List an agent's handoff events
Return the cross-agent handoff events in which this agent was the source or the target, newest first. Each entry records the source and target agent, the conversation it happened in, the reason, and a short summary of what was transferred. Pass the optional conversation_id query param to narrow the list to a single conversation. Powers the handoff divider chip in the conversation viewer.
GET
List an agent's handoff events
Authorizations
Dashboard JWT token from Clerk
Path Parameters
Identifier of the agent whose handoff events to list.
Query Parameters
Restrict the list to handoffs that occurred within this conversation.
Maximum number of handoff events to return (1–100, default 50).
Required range:
1 <= x <= 100