Revoke Delegated Subagent Key
x402_revoke_delegate_keyPermanently revoke one delegated subagent spend key by delegate_id (sbd_*), or revoke every active delegated key across the account when revoke_all=true. Use this immediately to disable a compromised, retired, or runaway subagent; do not use this for a temporary reversible pause across the whole account (use x402_set_account_freeze) or to adjust caps (use x402_update_delegate_key). Destructive and irreversible: revoked keys immediately fail with HTTP 401 and cannot be reactivated. Requires a master sbk_* spend key; provide either delegate_id (single key) or revoke_all=true (entire swarm).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "x402_revoke_delegate_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Optional audit-log reason for revocation (e.g. "key_rotated" or "compromised_worker"). | |
| 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. | |
| revoke_all | No | Set true to execute the emergency swarm kill switch revoking EVERY active delegated subagent key on the account (omit delegate_id when true). | |
| delegate_id | No | Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when revocation succeeded. | |
| revoked | No | True when a single delegated key was revoked. | |
| revoked_count | No | Number of delegated keys revoked when revoke_all=true. |