v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB

hitl

Relay an operator message on a handed-off conversation

Persist an OUTBOUND operator message (§6.4.1) then deliver it.

Persists a role='assistant' ConvMessage attributed to the relaying operator (authored_by='human_operator' + operator_actor_id), soft-claims the handoff if unassigned, then hands the already-persisted row to the channel delivery adapter (the adapter never mints a new message).

post/v1/hitl/handoffs/{handoff_id}/messages

Path parameters

handoff_idstring uuid required

Request body

contentstring required

Response

Successful Response

idstring uuid required

conversation_idstring uuid required

seqinteger required

rolestring required

contentstring nullable required

authored_bystring required

operator_actor_idstring nullable required

created_atstring date-time required