Request Human Approval
request_human_approvalAsk a named principal for a specific decision using the provisioned voice approval channel. Requires restricted approvals:write, a configured callback host and signing secret. Returns dispatch status; the signed callback carries the decision and evidence. No approval is implied by dispatch. SMS-only delivery is unavailable.
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": {
"source": "<source>",
"source_request_id": "<source_request_id>",
"principal_id": "<principal_id>",
"channel": "<channel>",
"summary": "<summary>",
"risk_level": "<risk_level>",
"expires_at": "<expires_at>",
"callback_url": "<callback_url>"
},
"name": "request_human_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Lowercase control-plane slug, e.g. "zehrava-gate". | |
| channel | Yes | ||
| summary | Yes | ||
| expires_at | Yes | ||
| message_id | No | ||
| risk_level | Yes | ||
| callback_url | Yes | Must be https and host-allowlisted. | |
| principal_id | Yes | ||
| required_factors | No | ||
| responds_to_hash | No | ||
| source_intent_id | No | ||
| source_request_id | Yes | ||
| callback_secret_id | No |