Appearance
Keys API Reference
POST /keys/rotate
Rotate the active signing key
Use during a signing-key maintenance window. The new EdDSA key signs immediately; the previous public key remains in JWKS for twice the configured access-token TTL. Accepts Idempotency-Key for safe retries.
Required permission — iam:keys:any Requires a user bearer with positive auth_time or step_up_time no older than ten minutes; timestamps up to 30 seconds in the future are accepted. Otherwise returns 403 step_up_required.
Responses
- 200 — Successful response
json
{
"kid": "01J8Z3KEY00000000000000002",
"retire_at": "2026-01-01T00:20:00Z"
}Errors
| Status | Code | Detail |
|---|---|---|
| 401 | authentication failed | Unauthorized |
| 403 | insufficient_permissions | Forbidden; Step-up Required |
| 403 | step_up_required | Forbidden; Step-up Required |
| 409 | idempotency_in_progress | Idempotency In Progress |
| 422 | idempotency_conflict | Idempotency Conflict |
| 500 | authentication service unavailable | Internal Server Error |