Update API key
Rename an API key.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your workspace API key. See Find your API key for more information.
Path Parameters
The workspace id.
The API key id.
Body
Response
Status OK.
The API key id.
The API key creation date.
The API key last update date.
The API key last use date.
An obfuscated hint of the API key value. When a key is created or rotated this also holds the full secret, for backward compatibility; prefer secret.
120"sk-o...5PW0"
The key's lifecycle state. active: the current secret authenticates. rotating: the key was rotated and the previous secret still authenticates until previousKeyExpiresAt. expired: expiresAt has passed, no secret authenticates, and the key can't be rotated.
active, rotating, expired "active"
The API key name.
120"Secret Key"
The full API key. Only present in the response that creates or rotates the key, and never shown again.
"sk-ol-Xq3v9Rk2mPz8TnW4yL7bC1dF5hJ6"
When the key stops authenticating. null means the key never expires. Set when the key is created or rotated, and must be in the future. When the request is authenticated with an API key that expires, the result can't be later than that key's expiry. On create, omit it to inherit that expiry. On rotate, omit it to keep the current one. It can't be changed with an update; rotate the key instead.
"2027-01-01T00:00:00Z"
When the key was last rotated.
While status is rotating, when the previous secret stops authenticating.