Skip to main content
GET
Get a handoff

Authorizations

x-api-key
string
header
required

Path Parameters

handoff_id
string<uuid>
required

Response

Successful Response

The API-response shape for a single handoffs row (UI + channel runtime).

id
string<uuid>
required
organization_id
string<uuid>
required
conversation_id
string<uuid>
required
conv_turn_id
string<uuid> | null
required
reason
string | null
required
static_text
string
required
status
enum<string>
required
Available options:
requested,
assigned,
accepted,
resolved,
cancelled
assignee
string | null
required
source
enum<string>
required
Available options:
workflow_terminal,
router,
policy,
call_transfer,
warm_call_transfer
packet
HandoffPacket · object
required

The complete, enriched handoff packet — the channel-runtime contract.

Two halves, by who fills them:

  • engine-supplied intent (rides on the handoff signal): reason, static_text, context_vars.
  • service-enriched at record time (needs DB access — packet.py): summary (from conversations.summary) and transcript_ptr.
created_at
string<date-time>
required
resolved_at
string<date-time> | null
required