Skip to main content
POST
Rotate Issuer Key
Creates a replacement key for an active key and atomically expires the old key for new issuance. The replacement stays in the same issuer and environment. Use its returned kid explicitly in subsequent mint requests; callers are not silently switched to another key.

Generate a replacement

Managed generation supports Ed25519, ES256, ES384, RS256, RS512, PS256 and PS512. For public-key import, supply kid, alg and public_key_b64url with DER SubjectPublicKeyInfo encoded as unpadded base64url. Imported public material alone cannot mint new records. See signing algorithms.

Existing records

Verification uses the registered issuance timestamp. Records issued before the old key’s cutoff can still pass signature verification with their original payload. A compromised or revoked key is rejected even for older records. Missing trusted timestamps cannot be replaced with a caller-supplied date. Success returns HTTP 201 with the replacement key and rotated_from. A retired key cannot be rotated again. Record expiry, revocation and signature checks continue to apply independently.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

kid
string
required

Body

application/json
provider
enum<string>
required

KMS generates a dedicated signing key. DEV registers public verification material only.

Available options:
KMS
alg
enum<string>

Signing algorithm matching the key.

Available options:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
kid
string
public_key_b64url
string

Unpadded base64url DER SubjectPublicKeyInfo; required for import, never send private key material.

Response

201 - application/json

Key rotated

kid
string

Key identifier

issuer_id
string<uuid>
algorithm
enum<string>

Signing algorithm for key generation

Available options:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
public_key
string

Base64-encoded public key

status
enum<string>
Available options:
ACTIVE,
DISABLED,
EXPIRED
not_before
string<date-time>
expires_at
string<date-time>