A new secret for the same key; the old one stops working at once. The expiry is kept. Only the key's creator may rotate it; an expired key is 404.
Authenticate with a signed-in session token (an API key cannot call this route).
Path parameters
The org's slug or id. A caller with no role in the org gets 404.
The key's id (key_…), not its secret.
Responses
200The key, with its new secret.
key_…; use it in the key routes.
key is minted here; oauth is an MCP client a person connected by signing in. An oauth grant reaches only the MCP server, cannot be rotated and has no webhook; its expires_at is when it ends unless the client refreshes it.
keyoauthThe secret's first characters, to tell keys apart.
2 fields
The runs the key started in the last seven days. Only in the list. finished counts runs
that ended completed or needs_review, out of ended. webhook_deliveries is the
state of each run's latest completion webhook: delivered, still being retried, or dropped
after the last try.
7 fields
Of runs, those started through MCP.
3 fields
The key's secret. Only in the create and rotate responses; never shown again.
The webhook signing secret. Only in the update response that minted it.
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.
404No such resource for the caller, including one in an org the caller is not in or a Project that is private to someone else.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.
429The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED).
The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED). The error names the limit. Wait Retry-After seconds.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.