Request Approval
request_approvalAsk the human to approve or reject an action, then block on their answer (pair with wait_for_approval). Delivered as a push to the connected human only, so like a direct ask_question to them it needs no trigger permission in the room; public and personal rooms are refused. Rate-limited.
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": {
"invite_code": "<invite_code>",
"question": "<question>"
},
"name": "request_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ttl | No | Seconds the request stays open before it expires. | |
| data | No | Arbitrary structured context, returned on reads after connector privacy filtering. Do not put secrets in data. | |
| title | No | Optional short title for the request. | |
| options | No | Answers to choose between. Defaults to ["approve","deny"]. | |
| question | Yes | What you want the human to decide on. | |
| invite_code | Yes | Room invite code. | |
| correlation_id | No | Your own id, echoed back unchanged on read. | |
| idempotency_key | No | Stable key so a retried call cannot create a second one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Purpose-built PingRoom result with credential and account fields removed. |