hitl_submit
Human-in-the-loop gate — submit any content (voice transcript, plan, action) for a human to review and optionally edit before your agent acts on it. Returns a mobile-friendly review URL the human opens, reads, edits if needed, then approves or rejects. After submitting, poll hitl_check({review_id}) every 5–10 seconds until status changes from 'pending'. When approved, use the returned content (may differ from original if human edited). WHEN TO USE: any agentic workflow where a client or team member must sign off before action — transcript review, plan approval, email draft, code change confirmation. CALL FORMAT: hitl_submit({content: transcript, context: 'This will be sent to the scheduling agent', expires_minutes: 10}).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The content for the human to review. Usually a voice transcript, plan, message draft, or list of proposed actions. Max 10,000 chars. | |
| context | No | What will happen with this content after approval — shown to the human so they understand the stakes. E.g. 'This transcript will be sent to the scheduling agent to book a meeting.' | |
| expires_minutes | No | How long the review link stays active. Default: 10 minutes. Max: 60 minutes. |