Issue Delegated Subagent Key
x402_issue_delegate_keyMint a new budget-capped, route-scoped, expiring delegated spend key (sbk_*) for a subagent or automated workflow backed by your master Stripe account. Use this to provision least-privilege spending credentials for a new subagent; do not use this to adjust limits on an existing key (use x402_update_delegate_key) or disable a key (use x402_revoke_delegate_key). Requires a master sbk_* spend key (delegated keys receive HTTP 403). Returns the secret child spend key exactly once — persist it in a secret store because later x402_get_account calls return only masked hints.
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": {
"label": "<label>"
},
"name": "x402_issue_delegate_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Human-readable label identifying the subagent or workflow (1-80 chars, e.g. "harbor-monitor-agent"). | |
| agent_id | No | Optional stable machine agent identifier recorded on spend audit rows (e.g. "agent.cursor.prod-01"). | |
| 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. | |
| ttl_hours | No | Key expiration window in hours from issuance (1 to 8760 hours = 1 year). Omit for non-expiring until revoked. | |
| 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 | Maximum USD cents allowed on any single capability call (e.g. 50 = $0.50). Omit for no per-call limit. | |
| daily_budget_cents | No | Rolling UTC-day spend cap in USD cents (e.g. 500 = $5.00/day). Omit for no daily cap. | |
| total_budget_cents | No | Lifetime cumulative spend cap in USD cents across the key lifespan (e.g. 2500 = $25.00 total). Omit for no lifetime cap. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the delegated key was minted. | |
| key_role | No | ||
| spend_key | No | One-time plaintext delegated subagent spend key (sbk_*). | |
| delegate_id | No | Delegated key identifier (sbd_*) used for future updates or revocation. |