List handoff events
Returns a paginated list of individual AI-to-human handoff events, newest first. Each event includes the AI-written summary and explanation of why it handed off, the handoff reasons, sentiment, and the session ID. Filter by reason (e.g. insufficient_tools) and date range to analyze recurring gaps.
get/handoff-analytics/events
Query parameters
cursorstring
Pagination cursor from a previous response
reason'ai_implied_handoff' | 'based_on_instructions' | 'instructions_not_clear' | 'insufficient_knowledge' | 'insufficient_tools' | 'prohibited_topic' | 'user_requested_human_assistance'
Only return handoffs that include this reason
start_datestring
Start date in ISO 8601 format (defaults to 30 days ago)
end_datestring
End date in ISO 8601 format (defaults to now)
Response
Default Response