Decide Spend Escalation Approval
x402_decide_approvalApprove once (15-minute single-use redemption window) or deny a pending subagent spend escalation ticket (sba_*). Use this as the master account operator after reviewing pending tickets via x402_get_account; do not use this to open a new escalation ticket (use x402_request_approval) or permanently change a subagent policy (use x402_update_delegate_key). Requires a master sbk_* spend key (delegated keys receive HTTP 403). Approved tickets bind exact principal, route, and cent amount and are atomically consumed on first spend to prevent replay (returns 404/409/410 if missing, already decided, or expired).
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": {
"approval_id": "<approval_id>",
"decision": "<decision>"
},
"name": "x402_decide_approval"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Optional operator audit note recorded with the approval or denial decision. | |
| decision | Yes | Operator decision: "approve" grants a single-use 15-minute execution pass; "deny" permanently rejects the escalation ticket. | |
| spend_key | No | Master Stripe account spend key (format: sbk_<43+ chars>). Delegated subagent keys are rejected with HTTP 403. Optional if supplied via the x-atlas-spend-key HTTP header. | |
| approval_id | Yes | Single-use human spend escalation approval ticket identifier returned by x402_request_approval (format: sba_<16 hex chars>, e.g. sba_aabbccddeeff0011). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the approval decision was recorded. | |
| approval | No | ||
| approval_id | No |