Request Spend Escalation Approval
x402_request_approvalCreate a pending single-use human escalation ticket (sba_*) when a delegated subagent needs one-time permission to exceed its standing per-call cap, budget, or route allowlist. Use this after x402_quote_plan returns human_approval_required=true on a delegated key; do not use this to approve/deny tickets (use x402_decide_approval) or permanently raise standing caps (use x402_update_delegate_key). Free and non-charging; requires a valid sbk_* spend key. Once approved by the master operator via x402_decide_approval, pass the returned approval_id to x402_execute_capability within 15 minutes.
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": {
"capability_id": "<capability_id>",
"justification": "<justification>"
},
"name": "x402_request_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cents | No | Exact USD cent amount requested for approval (optional for fixed-SKU capabilities where the hub auto-resolves the exact price). | |
| spend_key | No | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. | |
| ttl_minutes | No | Minutes the pending ticket remains open awaiting operator decision (1 to 1440; defaults to 60 minutes). | |
| capability_id | Yes | Target capability_id or route key requiring one-time over-cap execution (e.g. "audio_visual_isolate" or "POST /audio/visual-isolate"). | |
| justification | Yes | Concise human-readable reason explaining why this one-time spend exception is required (shown to the operator in the /x402/ approval queue). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the pending escalation ticket was recorded. | |
| approval | No | ||
| approval_id | No | Created single-use escalation ticket identifier (sba_*). |