The id a create returned reads as the sign-in while it is open (pending, or failed with an error), then as the connection it made, under that connection's own id.
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 id or name of an agent made from a template (POST /o/{org}/agents {template, name}).
The id the create returned, or a connection's own id from the list.
Responses
200The connection or its sign-in.
appmcpThe name a session's connections and the template use.
The agent the connection belongs to.
The MCP server's address.
1 fields
oauthbearernonependingconnectedfailedWhere the agent's user signs in. Single use; expires in 10 minutes.
2 fields
connection_expiredcancelled_by_callerconnection_failed4 item fields
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 agent, or no such connection of it (NOT_FOUND).
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.