Replace a key with its twin (same kind, mode, scopes, label). The old key keeps working until `replaced.expires_at` so a deploy can swap values without a gap. Needs the `keys` scope even to rotate itself — rotate a scoped key with a full key or from the dashboard. A key is rotated once: rotating it again is a 409 `key_already_rotated`, and during its grace the old key cannot mint, rotate, revoke or read deliveries (403 `key_rotated`). A test key cannot rotate a live key (403 `mode_mismatch`).

post/keys/rotate

Request

  • Base URL: https://widget.reelquoteai.com/api/v1
  • URL: https://widget.reelquoteai.com/api/v1/keys/rotate
  • Auth: HTTP bearer

Request body

idstring

Which key. Default: the key making this call.

grace_hoursinteger

0 revokes the old key immediately.

Response

The replacement, shown once, and when the old one stops

Example response

{
  "key": {
    "prefix": "sk_live_a1B2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.