List Teams Installations

GET

/org/:org_id/project/:project_id/integration/:integration_id/teams/installations

GET

/api/v1/org/:org_id/project/:project_id/integration/:integration_id/teams/installations

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/integration/integration_id/teams/installations \
>      -H "Authorization: Bearer <token>"

1 {
2   "auth_state": "connected",
3   "auth_state_reason": null,
4   "installations": [
5     {
6       "id": "019a5f1d-6ea4-7d27-a18b-7f40ad5e9163",
7       "tenant_id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
8       "team_id": "19:[email protected]",
9       "status": "active",
10       "created": "2024-01-16T13:33:25.247662Z",
11       "modified": "2024-01-16T13:41:07.512883Z",
12       "project_integration_id": "019a5f1d-7fb5-7d28-a29c-8051be6fa274",
13       "team_name": "Meridian Freight Operations"
14     }
15   ]
16 }

List the Teams installations linked to this integration, with the integration’s authorization state.

Returns the same installations and the same auth_state and auth_state_reason as the setup operation, without the install deep link. installations is empty until a Teams team has been linked.

Answers 422 when integration_id names an integration that is not of type teams.

List the Teams installations linked to this integration, with the integration's authorization state. Returns the same installations and the same `auth_state` and `auth_state_reason` as the setup operation, without the install deep link. `installations` is empty until a Teams team has been linked. Answers 422 when `integration_id` names an integration that is not of type `teams`.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

integration_idstringRequiredformat: "uuid"

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Response

Successfully retrieved Teams installations

auth_statestring or nullOptional

auth_state_reasonstring or nullOptional

installationslist of objectsOptional

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error