Skip to main content
POST
Escalate an agent conversation to a human

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

conversationId
string
required

Agent conversation identifier.

Body

application/json
reason
string

Free-text reason shown to the operator who receives the handoff.

Maximum string length: 1000
reason_category
enum<string>

Machine-readable handoff category for analytics. Inferred from the reason when omitted.

Available options:
cant_understand,
policy_block,
customer_request,
tool_failed,
escalation_threshold,
manual

Response

The conversation was escalated to a human

data
object
Example:
meta
object