rotate_api_key
Rotate an API key while preserving its identity and scopes, returning the new secret once; the previous secret stays valid during the transition window for safe caller updates.
Instructions
Rotate an API key without changing its identity or scopes. The new secret is returned once and exposed to this MCP transcript, while the previous secret remains valid until key_transition_expires_at. Store the new key securely, update callers during the transition window, and never log either secret.
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": {
"id": "<id>"
},
"name": "rotate_api_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | API key UUID obtained from list_api_keys | |
| key_transition_period_ms | No | Overlap in milliseconds while the previous key remains valid; minimum 1,800,000 (30 minutes), for example 3,600,000 for 1 hour |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Call succeeded | |
| data | No | Success payload | |
| error | No | Failure details |