# Integrations

The team's integrations and whether each is connected.

Source: https://docs.orbits.africa/api/integrations

An API token can list the team's integrations. Connecting, changing and disconnecting them (Git providers, Slack, Microsoft Teams, webhooks) holds the team's credentials with other services, so it is done in the dashboard. See [Integrations](https://docs.orbits.africa/team/integrations) and [Git](https://docs.orbits.africa/deploy/git).

Endpoints:

- `GET /v1/teams/{team}/integrations`: Catalog with installed state

## The integration object



- `key` (string, required)
- `name` (string, required)
- `category` (string, required): One of `source_code`, `notifications`, `payments`, `monitoring`.
- `description` (string)
- `available` (boolean): False when the integration is listed but cannot be installed yet.
- `installed` (boolean, required)
- `status` (string or null): One of `connected`, `needs_attention`.
- `summary` (string or null): One line for the Installed tab, e.g. "Repositories for shadyventures".
- `scope` (string or null)
- `installed_at` (string or null)
- `installed_by` (null or object)
  - `id` (string, required)
  - `name` (string, required)
- `fields` (array of object): Inputs needed to install. Secret values are never returned.
  - `name` (string, required)
  - `label` (string)
  - `secret` (boolean, required)
- `projects` (array of string)
## Catalog with installed state

```http
GET /v1/teams/{team}/integrations
```

The Integrations page: the Browse tab cards (name, description, Installed or Install) and the Installed tab rows (name, a one-line summary, scope, when it was installed, by whom).

**Permissions:** Any team member. A non-member gets 404.

Token: any API token (`read` or `full`).

Path parameters:

- `team`: Team slug or `team_` id.

Example:

```sh
curl "https://api.theorbits.app/v1/teams/my-team/integrations" \
  -H "Authorization: Bearer $ORBITS_TOKEN"
```

Response `200`:

```json
{
  "items": [
    {
      "key": "github",
      "name": "GitHub",
      "category": "source_code",
      "description": "Import repositories and deploy on every push.",
      "available": false,
      "installed": false,
      "status": "connected",
      "summary": null,
      "scope": "All projects",
      "installed_at": "2026-11-10T09:30:00Z",
      "installed_by": {
        "id": "id",
        "name": "my-app"
      },
      "fields": [
        {
          "name": "my-app",
          "label": "label",
          "secret": false
        }
      ],
      "projects": [
        "projects"
      ]
    }
  ]
}
```

Errors:

- `404`: Not found, or not visible to the caller (the two are indistinguishable on purpose).
- `502`: The Git providers' state could not be read.
