Skip to content
Connect an agent

Connections

List the apps you connected

The apps you approved that are still connected, newest first, with what each was granted.

GET/user/apps/connections

TL;DR

QuestionAnswer
What does it do?List the apps you connected.
What does it take?Nothing.
What does it return?Status 200 with a body of type AppConnectionList.
What can go wrong?401 not signed in; 429 too many requests. Every failure uses the one error envelope.

What it does

The apps you approved that are still connected, newest first, with what each was granted.

Responses

StatusMeaningBody
200The connected apps.AppConnectionList
401Not signed in.ErrorResponse
429Too many requests.ErrorResponse

Response body

A 200 answer has the type AppConnectionList.

FieldTypeRequiredDescription
itemsAppConnection[]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[].organisationobject | nullyes
items[].organisation.idstringyes
items[].organisation.slugstringyes
items[].organisation.namestringyes

See also

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