Skip to main content
POST
Record a cross-agent handoff (internal)

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
handoff_id
string
required

Caller-supplied idempotency key; a replay is a no-op.

source_agent_id
string
required

Agent delegating the conversation.

target_agent_id
string
required

Specialist agent receiving the conversation; must be on the source's handoff_targets allowlist.

conversation_id
string | null
reason
string | null
summary
string | null

Short recap of the conversation handed to the target agent.

Response

The handoff audit row was persisted (or replayed).

data
object
meta
object