Rotate merchant API key
shop.merchant.rotate_keyRevoke the current Bearer key and issue a new mk_live_ key shown once, enabling deactivated merchants to keep closing open orders.
Instructions
Revoke the Bearer key used for this call and return a fresh mk_live_ key (shown once). Works for deactivated merchants too, so open orders can still be closed.
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": "shop.merchant.rotate_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| encryption_key | No | Optional: ALSO replace the buyer-data encryption key. New kid, same sig_by_wallet rule as registration. Envelopes sealed to the old kid are not re-encrypted: fetch them first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | Yes | ||
| terms_update_pending | No | Present when a newer document version awaits re-acceptance (30-day window). |