An active app, as the connect page and the consent window show it

GET

/apps/{appId}

const url = 'https://api.eu.apigami.com/apps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.eu.apigami.com/apps/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0

Also served at /clients/{clientId}, its former name.

Parameters

Path Parameters

appId

required

string format: uuid

Responses

200

The app exists and its team has an active member.

application/json

object

appId

required

string format: uuid

clientId

required

The same value under its former name.

string format: uuid

name

required

string

groupName

required

The team that owns the app and chose its name.

string

avatarFileId

required

The app logo in the public avatars bucket. Null when no logo has been uploaded.

string | null format: uuid

verified

required

Whether Apigami has verified who runs the app. False: it connects at most ten users, and the approval window says so.

boolean

visibility

required

Who may connect: members of the team only (private), or anyone with the link.

string

Allowed values: private unlisted public

kind

required

mcp: the private app through which one person’s AI assistant acts. Every other app is authored.

string

Allowed values: authored mcp

Example

{
  "visibility": "private",
  "kind": "authored"
}

404

Unknown, or disabled.

application/json

object

error

required

string

consentPending

Present and true when the approval window is open and the user has not answered within 45 s.

boolean

Example

{
  "error": "not found"
}