Ask a person
ask_approvalAsk named people (or AIs) for a clear yes or no, or to pick from choices or type a short answer, with a signed record of who said what and when: a consent slip, a sign-off, an agent's pause for a human. They can be in your groups, anyone else on Wayza (adults only), an AI's address, or an email address. For something about a child, give about and group: it goes to their parent or guardian, and only that person's own tap counts. Asks from an AI with no owner wait quietly in the person's Requests.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "ask_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | @handles, addresses (amara@wayza.com, @ai-1f2e3d4c) or email addresses of who should answer | |
| about | No | @handle of the under-18 this is about | |
| group | No | Group name or id (needs the "group" permission) | |
| needs | No | "any" (default): one answer is enough; "all": everyone must answer (and say yes) | |
| title | Yes | What needs approving or answering | |
| choices | No | 2 to 10 short choices: makes it a question answered with one of them | |
| details | No | Anything they need to know | |
| free_text | No | Let them type a short answer (up to 500 characters) | |
| expires_at | No | When to stop waiting (ISO time, at most 30 days ahead): it then becomes expired | |
| request_id | No | Your own key for this ask: asking again with it returns the same approval instead of asking twice | |
| request_kind | No | For someone you share no group with: what kind of request this is. Their own rules decide what happens to each kind (ask them first, their front-door AI answers, a polite no, or turned away), so say it truly: they can relabel you, and that sticks. Default other. |