Mints a key that acts as the caller (any org member) on the session routes. The secret is in this response only; it is never stored or shown again. Without expires_at the key never expires.
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.
Request body
Defaults to both scopes.
Runs this key may have in progress at once.
4min 1max 100In the future and at most one year away.
Responses
201The key, with its 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.
400An invalid field (VALIDATION_ERROR).
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.
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.