The connections of one agent made from a template (POST /o/{org}/agents {template, name}), one per user of your own app. They belong to that agent alone: its runs use them and nothing else, and neither your own connections (GET /me/connections) nor another agent's appear here. Only the template's creator reads them. Each item has the shape GET /me/connections lists, with agent.
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}).
Responses
200The agent's connections.
10 item fields
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 made from a template of yours (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.
422The agent is a template or a plain agent, which runs on your own connections (INVALID_BODY).
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.