{"openapi":"3.1.0","info":{"title":"Ask a Human (Tech & Toast)","version":"0.1.0","description":"Pay one real human (Phil) to answer a question. Every answer is typed by a person, not generated. Answers are asynchronous: you get a ticket, the human answers within 24h, you poll for the answer or receive a callback.","x-guidance":"POST /api/x402/ask with a JSON body {question, context?, callback_url?} and pay $2 USDC on Base via x402 (HTTP 402 flow) for a short answer. Purpose-built variants: /api/x402/approve (approve, change or reject; $2), /api/x402/decide (a person picks one of your options; $2), /api/x402/feedback (human feedback in a few paragraphs; $8), /api/x402/review-media (design and video review; $8). The response contains ticket_id and get_answer, a URL to poll. GET /api/x402/answer/{ticket_id} returns {status} until answered, then {answer}. Use it when your instructions call for human approval or feedback and nobody is available, when you are stuck between options, for fractional-CTO and marketing judgment calls, taste and tone, a reality check before an irreversible step, or a tie-breaker between agents. Good questions: what something feels like, what a person would actually do, whether a plan is sensible. Attach up to 5 public https image/video URLs in attachments for design or video review; set preferred_human to ask for a kind of human (language, profession, place). Not for medical, legal or financial advice, tasks, private information about other people, or anything illegal (terms at /terms). Answers arrive within 24h; a late answer can be refunded. If you prefer MCP, connect to https://ai-to-human.techandtoast.io/api/mcp and start with the about_this_human tool; the first question there is free.","contact":{"name":"Phil Graci, Tech & Toast","email":"phil@techandtoast.io","url":"https://ai-to-human.techandtoast.io"},"termsOfService":"https://ai-to-human.techandtoast.io/terms"},"servers":[{"url":"https://ai-to-human.techandtoast.io"}],"tags":[{"name":"Human","description":"A real person answers."}],"paths":{"/api/x402/ask":{"post":{"operationId":"askHuman","summary":"Ask a human: one question, answered by a real person within 24h","description":"Ask one real human (not a model) a question. A person types a short answer (1-3 sentences, ~100 tokens) within 24h. Good for judgment, taste, lived experience and what a real person would do. Returns a ticket id and a URL to poll; optional callback_url is POSTed when the answer lands.","tags":["Human"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","minLength":5,"maxLength":2000,"description":"The question for the human."},"context":{"type":"string","maxLength":4000,"description":"Optional background."},"attachments":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri"},"description":"Optional public https image/video URLs."},"callback_url":{"type":"string","format":"uri","description":"Optional URL to POST {ticket_id, answer} to when answered."},"preferred_human":{"type":"string","maxLength":300,"description":"Optional: the kind of human you want (language, profession, place)."}},"required":["question"]},"example":{"question":"Is moving countries at 50 a mistake?","context":"Software founder, no kids."}}}},"responses":{"200":{"description":"Ticket created; a human will answer","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"expected_by":{"type":"string","format":"date-time"},"min_words":{"type":"integer"},"get_answer":{"type":"string","format":"uri"},"note":{"type":"string"}},"required":["ticket_id","expected_by","get_answer"]}}}},"400":{"description":"Invalid body"},"402":{"description":"Payment Required"}}}},"/api/x402/approve":{"post":{"operationId":"humanApproval","summary":"Human approval: a person reviews a plan, message, spend or deploy and replies approve, change or reject","description":"Human approval for agents. Send a proposal (an email to send, a spend, a deploy, a plan, a reply to a customer). A real person reviews it and answers APPROVE, CHANGE (with what to change) or REJECT (with why), within 24h. A human reviewer's judgment, not a legal or financial authorization.","tags":["Human"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"proposal":{"type":"string","minLength":5,"maxLength":2000,"description":"What you want approved, in full."},"context":{"type":"string","maxLength":4000,"description":"Why, for whom, and what happens if approved."},"risks":{"type":"string","maxLength":1000,"description":"Optional: what you are unsure about."},"attachments":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri"},"description":"Optional public https image/video URLs."},"callback_url":{"type":"string","format":"uri","description":"Optional URL to POST {ticket_id, answer} to when answered."},"preferred_human":{"type":"string","maxLength":300,"description":"Optional: the kind of human you want (language, profession, place)."}},"required":["proposal"]},"example":{"proposal":"Send this refund-denial email to the customer: 'Hi Sam, we can't refund after 30 days, but here's a 20% credit…'","context":"Customer bought 41 days ago; policy is 30 days; they are a repeat buyer."}}}},"responses":{"200":{"description":"Ticket created; a human will answer","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"expected_by":{"type":"string","format":"date-time"},"min_words":{"type":"integer"},"get_answer":{"type":"string","format":"uri"},"note":{"type":"string"}},"required":["ticket_id","expected_by","get_answer"]}}}},"400":{"description":"Invalid body"},"402":{"description":"Payment Required"}}}},"/api/x402/feedback":{"post":{"operationId":"humanFeedback","summary":"Human feedback on copy, a plan, a product idea or UX","description":"Human feedback for agents. Send copy, a landing page, a plan, a product idea or a UX flow; a real person says what lands, what does not, and what to change in a few paragraphs (~400 tokens), within 24h. Optional audience and specific question. Images or video can be attached as public URLs.","tags":["Human"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"8.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":5,"maxLength":2000,"description":"The thing to give feedback on (text, or a description plus attachments)."},"ask":{"type":"string","maxLength":500,"description":"Optional: the specific question, e.g. 'is the headline clear?'"},"audience":{"type":"string","maxLength":300,"description":"Optional: who it is for."},"attachments":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri"},"description":"Optional public https image/video URLs."},"callback_url":{"type":"string","format":"uri","description":"Optional URL to POST {ticket_id, answer} to when answered."},"preferred_human":{"type":"string","maxLength":300,"description":"Optional: the kind of human you want (language, profession, place)."}},"required":["content"]},"example":{"content":"Headline: 'Ship agents that ask before they act.' Subhead: 'Human sign-off as an API.'","ask":"Would a developer click?","audience":"Indie AI developers"}}}},"responses":{"200":{"description":"Ticket created; a human will answer","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"expected_by":{"type":"string","format":"date-time"},"min_words":{"type":"integer"},"get_answer":{"type":"string","format":"uri"},"note":{"type":"string"}},"required":["ticket_id","expected_by","get_answer"]}}}},"400":{"description":"Invalid body"},"402":{"description":"Payment Required"}}}},"/api/x402/review-media":{"post":{"operationId":"humanDesignReview","summary":"Design and video review by a person: logos, layouts, thumbnails, ad creative, video cuts","description":"Design and video review by a real person. Attach 1 to 5 public image or video URLs (logo, layout, thumbnail, ad creative, video cut) and an optional question such as 'which would you click?' or 'is this edit paced right?'. A human looks at them and answers in a few paragraphs within 24h.","tags":["Human"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"8.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"attachments":{"type":"array","minItems":1,"maxItems":5,"items":{"type":"string","format":"uri"},"description":"Public https image/video URLs, 1 to 5."},"question":{"type":"string","maxLength":1000,"description":"Optional: what you want to know."},"callback_url":{"type":"string","format":"uri","description":"Optional URL to POST {ticket_id, answer} to when answered."},"preferred_human":{"type":"string","maxLength":300,"description":"Optional: the kind of human you want (language, profession, place)."}},"required":["attachments"]},"example":{"attachments":["https://ai-to-human.techandtoast.io/opengraph-image"],"question":"Does this read as premium or cheap?"}}}},"responses":{"200":{"description":"Ticket created; a human will answer","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"expected_by":{"type":"string","format":"date-time"},"min_words":{"type":"integer"},"get_answer":{"type":"string","format":"uri"},"note":{"type":"string"}},"required":["ticket_id","expected_by","get_answer"]}}}},"400":{"description":"Invalid body"},"402":{"description":"Payment Required"}}}},"/api/x402/decide":{"post":{"operationId":"humanDecision","summary":"Tie-breaker: a person picks one of your options and says why","description":"A human tie-breaker for agents. Give 2 to 6 options and the question; a real person picks one and explains why, within 24h. For when two agents or models disagree, or an operator is not available to choose. A second opinion from a person.","tags":["Human"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","minLength":5,"maxLength":1000,"description":"What needs deciding."},"options":{"type":"array","minItems":2,"maxItems":6,"items":{"type":"string","maxLength":500},"description":"The options to choose from."},"context":{"type":"string","maxLength":4000,"description":"Optional background."},"callback_url":{"type":"string","format":"uri","description":"Optional URL to POST {ticket_id, answer} to when answered."},"preferred_human":{"type":"string","maxLength":300,"description":"Optional: the kind of human you want (language, profession, place)."}},"required":["question","options"]},"example":{"question":"Rewrite the module or patch it before Friday's release?","options":["Rewrite now","Patch now, rewrite next sprint"],"context":"2 devs, 4 days."}}}},"responses":{"200":{"description":"Ticket created; a human will answer","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"expected_by":{"type":"string","format":"date-time"},"min_words":{"type":"integer"},"get_answer":{"type":"string","format":"uri"},"note":{"type":"string"}},"required":["ticket_id","expected_by","get_answer"]}}}},"400":{"description":"Invalid body"},"402":{"description":"Payment Required"}}}},"/api/x402/answer/{ticket_id}":{"get":{"operationId":"getAnswer","summary":"Fetch the human's answer for a ticket (free)","tags":["Human"],"security":[],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ticket status, with the answer once written","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string"},"status":{"type":"string","enum":["queued","answered","refunded","rejected"]},"expected_by":{"type":"string","format":"date-time"},"answer":{"type":"string"},"answered_at":{"type":"string","format":"date-time"}},"required":["ticket_id","status"]}}}},"404":{"description":"Unknown ticket"}}}}}}