List the accounts and MCP servers connected to one agent made from a template.

GET/o/{org}/agents/{agent}/connections
View .md

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

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

agentstringrequired

The id or name of an agent made from a template (POST /o/{org}/agents {template, name}).

Responses

200The agent's connections.
connectionsarray of AgentConnectionrequired
10 item fields
idstringrequired
Format uuid
typestringrequired
One ofappmcp
namestringoptional

The name a session's connections and the template use.

agentstringrequired

The agent the connection belongs to.

Format uuid
urlstringoptional

The MCP server's address.

Format uri
authobjectoptional
1 fields
modestringoptional
One ofoauthbearernone
statusstringrequired
One ofpendingconnectedfailed
authorize_urlstringoptional

Where the agent's user signs in. Single use; expires in 10 minutes.

Format uri
errorobjectoptional
2 fields
codestringoptional
One ofconnection_expiredcancelled_by_callerconnection_failed
messagestringoptional
toolsarray of objectoptional
4 item fields
namestringoptional
titlestringoptional
descriptionstringoptional
read_onlybooleanoptional
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such agent made from a template of yours (NOT_FOUND).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
422The agent is a template or a plain agent, which runs on your own connections (INVALID_BODY).
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
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.

errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional