Skip to content
Connect an agent

Organisations

List the apps connected to an organisation

The apps members approved for the organisation, newest first, with who approved each.

GET/orgs/{org}/app-connections

TL;DR

QuestionAnswer
What does it do?List the apps connected to an organisation.
What does it take?org in the path.
What does it return?Status 200 with a body of type OrgAppConnectionList.
What can go wrong?401 not signed in; 403 a member or a reader may not look (orgs.forbidden); 404 no such organisation, or the caller is not a member of it; 429 too many requests; 503 organisations are not set up on this server. Every failure uses the one error envelope.

What it does

The apps members approved for the organisation, newest first, with who approved each. The owner and an admin may look.

Path parameters

FieldTypeRequiredDescription
orgstringyesThe organisation's id or its slug.

Responses

StatusMeaningBody
200The connected apps.OrgAppConnectionList
401Not signed in.ErrorResponse
403A member or a reader may not look (orgs.forbidden).ErrorResponse
404No such organisation, or the caller is not a member of it.ErrorResponse
429Too many requests.ErrorResponse
503Organisations are not set up on this server.ErrorResponse

Response body

A 200 answer has the type OrgAppConnectionList.

FieldTypeRequiredDescription
itemsOrgAppConnection[]yes
items[].idstringyes
items[].appobjectyes
items[].app.idstringyesThe app's id, which is its OAuth client_id.
items[].app.namestringyes
items[].app.homepagestring | nullyes
items[].scopesAppScope[]yes
items[].connectedAtintegeryes
items[].lastUsedAtinteger | nullyes
items[].connectedByobjectyes
items[].connectedBy.userIdstringyes
items[].connectedBy.emailstringyes

See also

DocWhy
API referenceEvery endpoint, and the error envelope
SchemasEvery request and response type
Tool referenceThe operations as callable tools