Skip to main content
Replaces the key material and returns the new value once. The previous value stops working immediately.
Rotation is not naturally idempotent: every call mints a new key and stops the previous one. When retrying over an unreliable network, always send an Idempotency-Key — a blind retry would invalidate the key you just received.
Permission required: service_account:update (your own keys only) or service_account:update (all keys)

Path Parameters

string
required
Identifier of the API key

Headers

string
Optional. Retrying with the same value replays the first result — it does NOT mint a second key.

Response

object

Errors

Errors answer with success: false, a message and an error_code. See Error Codes for every code.