rotate_agent_key
Revoke a compromised or aging agent key and receive a replacement that preserves existing permissions. Use on suspected leaks or for scheduled rotation.
Instructions
Atomically revoke an agent key and mint its replacement (inherits label/permissions unless overridden). The new plaintext key is returned ONCE. Use on suspected leak or on a rotation schedule. Requires a developer key (floe_live_...).
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": {
"agent_id": "<agent_id>",
"key_id": "<key_id>"
},
"name": "rotate_agent_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Optional new label; omit to inherit. | |
| key_id | Yes | Key id to rotate (from the agent's key list). | |
| agent_id | Yes | Numeric agent id. |