Auth

Roll API key

Replaces the key secret while keeping its name and identity in the key list. The previous secret stops working immediately. The new secret is minted with the current plan tier rate limit and is returned only once. Requires an owner or admin session/OAuth principal; API keys cannot roll themselves.

post/v1/auth/keys/{keyId}/roll

Path parameters

keyIdstring required

API key identifier.

Query parameters

organizationIdstring

Organization the key belongs to. Defaults to the active organization.

Response

The rolled key. The plaintext secret is returned only once.

successtrue required

Changes

No recorded changes to this endpoint across all 1 revision of this API.