Skip to main content
POST
Rotate API key

Path Parameters

key_prefix
string
required

Body

application/json

Optional body for POST /v1/keys/{key_prefix}/rotate.

grace_period_hours keeps the old key valid for the chosen window instead of revoking it immediately. 0 (the default) matches the legacy instant-revoke behaviour. The UI exposes presets of 0, 1, 24, 72, and 168 hours; any non-negative integer is accepted.

grace_period_hours
integer
default:0

Response

New key issued - old key revoked

Response from key rotation.

old_prefix
string
required
new_key
string
required
new_prefix
string
required