Rotate an API key

Replaces one of your personal API keys by a new one.

POST /account/api-keys/{keyId}/rotate

Access: Session token only. API keys get 403 with insufficient_scope.

The new key has the same name, scopes, owner and lifetime as the old one. If the organisation limits the lifetime of API keys, the new key lives at most that long. The old key stops working at once. The new value is shown only in this response.

Response 201 #

{ "token": "ct_live_...", "keys": [] }

token is the new key. keys is the list as the list route gives it.

Errors #

| 404 | not_found | There is no such key of yours, or an id is not a UUID. | | 429 | rate_limited | Too many requests, see Rate limiting. |

See Errors for the error format.