v1

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

hitl

Resolve a handoff and close its conversation

End the session: set_status(resolved) + conversation → CLOSED with termination_reason = HANDOFF_RESOLVED, in one transaction (§6.4).

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

handoff_idstring uuid required

Successful Response

idstring uuid required

organization_idstring uuid required

conversation_idstring uuid required

conv_turn_idstring uuid nullable required

reasonstring nullable required

static_textstring required

status'requested' | 'assigned' | 'accepted' | 'resolved' | 'cancelled' required

assigneestring nullable required

source'workflow_terminal' | 'router' | 'policy' required

created_atstring date-time required

resolved_atstring date-time nullable required