Ask my human a question by email
ask_humanAsk your human owner a question by email (needs an ask-my-human utility from buy). Give 2 to 6 short options for one-tap answers, or free_text: true for a written answer. Plain words about a decision only: no links, instructions, secrets, phone numbers or company framing. Returns ask_id; keep it, as no tool lists asks: poll get_ask with it, or pass inbox_instance_id to get the answer in your webhook inbox. Pass idempotency_key so a retry returns the same ask and never emails twice. Your owner confirms on a page, so an answer can take hours.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"options": [
"Monday",
"Friday"
],
"question": "Release on Monday or Friday?",
"instance_id": "ask_exampleexampleexample2"
},
"name": "ask_human"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | 2 to 6 distinct labels, up to 60 characters each. | |
| question | Yes | Up to 500 characters of plain words. | |
| free_text | No | true: your owner writes the answer. Do not send options then. | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. | |
| idempotency_key | No | Your own id for this question: a retry with the same key returns the same ask. | |
| expires_in_hours | No | Hours your owner has to answer, 1 to 168 (default 72), and not past the plan's end. | |
| inbox_instance_id | No | One of your webhook inboxes (inb_...): the answer is also delivered there, with its ask_id. |