Organisations

List your agents in an organisation

The agents you connected to this organisation, and its keys you made that an agent has used, each with where it stands.

GET/orgs/{org}/agents/mine

TL;DR

Question	Answer
What does it do?	List your agents in an organisation.
What does it take?	`org` in the path.
What does it return?	Status 200 with a body of type `AgentList`.
What can go wrong?	`401` not signed in; `403` the organisation requires two-step sign-in and this account does not have it on (`orgs.two_factor_required`); `404` no such organisation, or the caller is not a member of it; `429` too many requests. Every failure uses the one error envelope.

The agents you connected to this organisation, and its keys you made that an agent has used, each with where it stands. Only yours.

Field	Type	Required	Description
`org`	`string`	yes	The organisation's id or its slug.

Status	Meaning	Body
200	Your agents in the organisation.	`AgentList`
401	Not signed in.	`ErrorResponse`
403	The organisation requires two-step sign-in and this account does not have it on (`orgs.two_factor_required`).	`ErrorResponse`
404	No such organisation, or the caller is not a member of it.	`ErrorResponse`
429	Too many requests.	`ErrorResponse`

A 200 answer has the type AgentList.

Field	Type	Required	Description
`items`	`Agent[]`	yes
`items[].id`	`string`	yes
`items[].credential`	`"oauth" \| "key"`	yes	How it signs in: a browser sign-in (OAuth) or an API key in its settings.
`items[].name`	`string`	yes	The connection's registered agent name, or the key's name.
`items[].agent`	`object \| null`	yes	What the agent called itself (`clientInfo`) when it last opened an MCP session, or null when it never has.
`items[].agent.name`	`string`	yes
`items[].agent.version`	`string \| null`	yes
`items[].orgId`	`string \| null`	yes
`items[].createdAt`	`integer`	yes
`items[].lastUsedAt`	`integer \| null`	yes	Its last call, to within five minutes.
`items[].sessionAt`	`integer \| null`	yes	When it last opened an MCP session.
`items[].expiresAt`	`integer \| null`	yes
`items[].status`	`"live" \| "ready" \| "idle" \| "waiting" \| "blocked"`	yes	`live`: a call in the last 15 minutes. `ready`: in the last 30 days. `idle`: earlier. `waiting`: never used. `blocked`: its next call would be refused, and `blocked` says why.
`items[].blocked`	`"expired" \| "network" \| "two_factor" \| "membership" \| "policy" \| null`	yes

Doc	Why
API reference	Every endpoint, and the error envelope
Schemas	Every request and response type
Tool reference	The operations as callable tools