{"uid":"cap_n6vOPRpfLnB7-VIkwNKCV","slug":"request-a-human-closed-choice-multiple-choice-question-1242da32","name":"Request a Human – Closed-Choice (Multiple-Choice) Question","description":"Ask a real person a multiple-choice question: how a message feels, which option a person would prefer, or whether to go ahead with an action before you take it. Send 'question' and 2-6 'options'; a human picks one within 24 h. Poll the returned status_url. Not for facts or code. Declined or late requests are refunded.","url":"https://agents.requestahuman.com/ask/closed?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"context":{"type":"string","description":"Background and constraints, at most 200 words."},"options":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":6,"minItems":2,"description":"Answer options; the human picks one."},"question":{"type":"string","description":"What you need from the human, at most 50 words."},"follow_up_of":{"type":"string","pattern":"^[0-9a-f]{16}$","description":"job_id of an earlier request: the same person answers and sees it."},"refund_address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Where refunds go (default: the paying address)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y4twGYIZjMsbyWjYJa5Ze","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Posts a multiple-choice question to a real human who selects one of 2–6 provided options within 24 hours, returning human judgment on preference, tone, or approval decisions.","exampleAgentPrompt":"Before I send the apology email to the client, ask a real human which version feels more sincere — give them these two options: 'We sincerely apologize for the delay and are working to fix it immediately.' or 'We're sorry about this — it's on us and we're on it.' They have up to 24 hours to pick one.","exampleUseCases":[{"title":"Tone check before customer email","prompt":"I've drafted two subject lines for our re-engagement email — can you ask a real person which one feels more compelling? Option A: 'We miss you — here's something special.' Option B: 'Your exclusive offer is waiting inside.' Give them context that this is for a loyalty campaign targeting lapsed customers."},{"title":"Pre-action approval for irreversible bot task","prompt":"Before my agent posts the public apology tweet, I want a human to approve it — ask them: 'Should I post this apology now or hold until Monday?' with options 'Post it now' and 'Wait until Monday', and add context that the issue was resolved an hour ago."},{"title":"Product naming preference vote","prompt":"Ask a real human which name they prefer for our new feature: 'SmartSync', 'AutoLink', or 'FlowBridge' — give them context that it's a data integration tool for small business owners and I need their gut reaction."}],"resultDescription":"Returns a status URL to poll for the human's answer. Once the person responds (within 24 hours), the polled status endpoint reveals which option they selected. If the request is declined or times out, the $1 USDC payment is refunded to the paying or specified refund address.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:37:51.119Z","isFirstParty":false,"canonicalSlug":"request-a-human-closed-choice-multiple-choice-question-1242da32"}