Skip to content
Connect an agent

Connections

List the apps you registered

Your apps, newest first.

GET/user/apps/registered

TL;DR

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

What it does

Your apps, newest first. The secret is never shown again.

Responses

StatusMeaningBody
200Your apps.RegisteredAppList
401Not signed in.ErrorResponse
429Too many requests.ErrorResponse

Response body

A 200 answer has the type RegisteredAppList.

FieldTypeRequiredDescription
itemsRegisteredApp[]yes
items[].idstringyesThe app's id, which is its OAuth client_id.
items[].namestringyesShown to people as a claim on the consent page.
items[].homepagestring | nullyes
items[].clientType"confidential" | "public"yesconfidential holds a client secret on its server; public (a page or a tool with no server) holds none.
items[].redirectUrisstring[]yes
items[].membersOnlybooleanyesFor an organisation's app: only its members may connect it, to the organisation.
items[].hasSecretbooleanyes
items[].createdAtintegeryesMilliseconds since the epoch.
items[].updatedAtintegeryesMilliseconds since the epoch.

See also

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