Skip to main content
POST
Rotate ONE key; sibling keys of the same kind keep working

Authorizations

Authorization
string
header
required

Locus Pro dashboard session (Cognito).

Path Parameters

keyId
string<uuid>
required

Key record id from GET /credits/tenants/me/keys.

Body

application/json
gracePeriodSeconds
integer

Overlap during which the old key still works. Omitted or 0 means it dies with this response.

Required range: 0 <= x <= 86400
expiresIn
integer

Lifetime of the replacement in seconds. Omit to inherit the target's deadline.

Required range: 60 <= x <= 31536000

Response

New raw key (returned exactly once) with keyMetadata.