Skip to content

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 ​

StatusCodeDetail
401authentication failedUnauthorized
403insufficient_permissionsForbidden; Step-up Required
403step_up_requiredForbidden; Step-up Required
409idempotency_in_progressIdempotency In Progress
422idempotency_conflictIdempotency Conflict
500authentication service unavailableInternal Server Error