Rotate a key

View as Markdown
PUT
/keys/{key_id}/rotate

Rotates the specified cryptographic key by generating a new key version and promoting it as the active signing key. The previous key is retained for validation to ensure continuity for previously issued tokens.

This operation is irreversible.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

key_id*string

The unique identifier of the key.

Response

204

The key was rotated successfully

Errors

401Unauthorized
403Forbidden

curl -X PUT "https://your-domain.us.monocloud.com/api/keys/tXcwKNmJfReWTjVIP6Wtd/rotate" \  -H "X-API-KEY: <token>"
Empty
© 2026 MonoCloud. All rights reserved.