Skip to main content
POST
Rotate a key

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

source_id
string<uuid>
required
key_id
string
required

Body

application/json
grace_seconds
integer | null

How long the old key keeps working. Defaults to 24 hours; 0 revokes it at once.

Required range: 0 <= x <= 604800

Response

The new key and its secret, shown this once.

key
KeyOut · object
required
secret
string
required

The full key. Shown once; Niadra keeps only two hashes of it.