Request a Human – Closed-Choice (Multiple-Choice) Question

Use this endpoint when you need a human to choose from a predefined set of options — such as which message tone feels right, which option they'd prefer, or whether to approve an action — and the answer cannot be derived from facts, code, or AI reasoning alone. Prefer this over the open-answer sibling endpoint when the possible responses are bounded and you want a clean, unambiguous selection. Not appropriate for factual lookups, code generation, real-world physical tasks, or any use case requiring a free-text written response.

• Human does not respond within 24 hours — request is marked expired and payment refunded
• Human declines the question — request is marked declined and payment refunded
• Question exceeds 50-word limit — request rejected at submission
• Fewer than 2 or more than 6 options provided — schema validation error
• follow_up_of job_id does not match a valid prior job — error returned
• Invalid refund_address format — schema validation error
• Payment of $1 USDC not received — request not created