Read one of an agent's connections, or the sign-in that makes it.

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

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

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}).

connectionstringrequired

The id the create returned, or a connection's own id from the list.

Format uuid

Responses

200The connection or its sign-in.
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, or no such connection of it (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
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