Update Delegated Key Policy
x402_update_delegate_keyModify standing spend limits, route allowlist, or label on an active delegated subagent key (sbd_*) live without rotating its secret. Use this to tighten or expand ongoing budgets for an existing subagent; do not use this to mint a new key (use x402_issue_delegate_key), grant a single-use exception (use x402_decide_approval), or permanently disable a key (use x402_revoke_delegate_key). Requires a master sbk_* spend key; idempotent for identical policy payloads. Returns HTTP 403 for delegated callers and HTTP 404 if delegate_id is unknown.
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": {
"delegate_id": "<delegate_id>"
},
"name": "x402_update_delegate_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Updated human-readable label for the delegated subagent key. | |
| 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. | |
| delegate_id | Yes | Unique delegated subagent key identifier returned by x402_issue_delegate_key or x402_get_account (format: sbd_<16 hex chars>, e.g. sbd_1122334455667788). | |
| allowed_routes | No | Route allowlist patterns restricting which capabilities the delegated key may invoke (supports exact routes like "POST /kb/search" or prefix wildcards like "GET /reality/*"). Omit or pass [] to allow all hub capabilities. | |
| max_order_cents | No | Updated per-call spend cap in USD cents, or null to clear the per-call cap. | |
| daily_budget_cents | No | Updated UTC daily budget cap in USD cents, or null to clear the daily cap. | |
| total_budget_cents | No | Updated lifetime cumulative cap in USD cents, or null to clear the lifetime cap. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the delegate policy was updated. | |
| delegate | No | Full updated delegate policy and live spend counters. | |
| delegate_id | No | Updated delegated key identifier (sbd_*). |