Skip to main content
POST
Handoff conversation from AI to a human

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

id
string
required

Body

application/json
reason
string

Short reason — surfaced to the receiving human (e.g. 'asked for a manager').

Maximum string length: 500
target_queue
string

Optional queue to route to. Defaults to the tenant's default queue.

Maximum string length: 100
reason_category
enum<string>

Machine-readable handoff category for analytics. When omitted, inferred from the free-text reason.

Available options:
cant_understand,
policy_block,
customer_request,
tool_failed,
escalation_threshold,
manual
skill_tags
string[]

Caller override for the skill set used to match operators. When omitted, derived from the conversation's most recent AI agent's skill_tags.

Maximum array length: 20
Maximum string length: 40
brief
string

Caller-supplied 2-3 sentence summary. When omitted, the service generates one via the LLM gateway.

Maximum string length: 600

Response

200

Default Response