API reference · TeamIntegrations
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 and Git.
The integration object
Fields
keystringrequirednamestringrequiredcategorystringrequiredOne of
source_code,notifications,payments,monitoring.descriptionstringavailablebooleanFalse when the integration is listed but cannot be installed yet.
installedbooleanrequiredstatusstring or nullOne of
connected,needs_attention.summarystring or nullOne line for the Installed tab, e.g. "Repositories for shadyventures".
scopestring or nullinstalled_atstring or nullinstalled_bynull or objectShow 2 child fieldsHide child fields
idstringrequirednamestringrequired
fieldsarray of objectInputs needed to install. Secret values are never returned.
Show 3 child fieldsHide child fields
namestringrequiredlabelstringsecretbooleanrequired
projectsarray of string
Catalog with installed state
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.
Headers
AuthorizationstringrequiredBearerand your API token:Bearer orb_live_….
Path parameters
teamstringrequiredTeam slug or
team_id.
Response 200
Catalog.itemsarray of IntegrationrequiredShow 13 child fieldsHide child fields
keystringrequirednamestringrequiredcategorystringrequiredOne of
source_code,notifications,payments,monitoring.descriptionstringavailablebooleanFalse when the integration is listed but cannot be installed yet.
installedbooleanrequiredstatusstring or nullOne of
connected,needs_attention.summarystring or nullOne line for the Installed tab, e.g. "Repositories for shadyventures".
scopestring or nullinstalled_atstring or nullinstalled_bynull or objectShow 2 child fieldsHide child fields
idstringrequirednamestringrequired
fieldsarray of objectInputs needed to install. Secret values are never returned.
Show 3 child fieldsHide child fields
namestringrequiredlabelstringsecretbooleanrequired
projectsarray of string
Errors
- 404Not found, or not visible to the caller (the two are indistinguishable on purpose).
- 502The Git providers' state could not be read.
Every code is explained in Errors.
curl "https://api.theorbits.app/v1/teams/my-team/integrations" \
-H "Authorization: Bearer $ORBITS_TOKEN"{
"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"
]
}
]
}