Update API key
Rename one of your API keys. A key’s expiry can’t be updated; rotate the key with a new expiresAt instead, so extending a key’s life always issues a new secret.
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 and no secret authenticates.
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.
"2027-01-01T00:00:00Z"
When the key was last rotated.
While status is rotating, when the previous secret stops authenticating.