Rotate an API key
Replaces the secret of an API key with a newly generated one. The old value stops working immediately; there is no grace period, so update every place that uses the key right after rotating it. The key keeps its id, label, and role, and signing in afterwards returns the new value.
The new key is returned once, in apiKey. Store it: later reads only show a preview.
Owner keys can rotate any owner key on the account. A member key can rotate only that member’s own key. Find a key’s id with Get the current account; the key making the request is marked current: true.
Authentication
Your Dial API key, sent as Authorization: Bearer sk_live_...
Path parameters
Response
The key was rotated. apiKey holds the new value and is shown only here.
The new key value. Returned only in this response; store it now.