---
title: "List Integrations"
method: GET
path: "/v1/integrations"
tags: ["v1"]
---

# List Integrations

`GET /v1/integrations`

## Request

- Base URL: `https://api.ellipsis.dev`
- URL: `https://api.ellipsis.dev/v1/integrations`
- Auth: HTTP bearer

List connected integrations.

A read-only view, so an agent authoring another agent's
config can learn which repositories, channels, teams, and
organizations it may name before POST /agents.

Available to all credential types including session tokens: the
responses never include OAuth tokens or any other secret.

## Headers

- `user-agent` string, nullable

## Response `200`

Successful Response

- GetIntegrationsResponse: Everything connected for the calling account, in one call. A key is null (or an empty list for sentry) when that integration isn't connected, so callers can see the full universe of integrations, not just the connected ones.
  - `github` GithubIntegrationSummary: The account's GitHub App installation. Always present in practice: an account *is* a GitHub account, so `null` means the app was uninstalled.
    - `account_login` string, required: The GitHub login of the installed account.
    - `account_type` 'User' | 'Organization' | 'Bot' | 'Mannequin', required
    - `created_at` string, date-time, required
    - `id` integer, required
    - `needs_permissions_update` boolean, required
    - `repository_count` integer, required: How many repositories the installation can access.
    - `repository_selection` 'all' | 'selected', required
    - `suspended` boolean, required: Whether the installation is currently suspended on GitHub.
    - `suspended_at` string, date-time, nullable
    - `updated_at` string, date-time, required
  - `jira` JiraIntegrationSummary: The account's connected Jira site.
    - `cloud_id` string, required: The Jira cloud site id.
    - `created_at` string, date-time, required
    - `scope` string[], required
    - `updated_at` string, date-time, required
  - `linear` LinearIntegrationSummary: The account's connected Linear organization and its teams.
    - `created_at` string, date-time, required
    - `organization_id` string, required: The Linear organization id.
    - `teams` LinearTeam[], required: The organization's teams.
      - `id` string, required: The Linear team id.
      - `is_enabled` boolean, required: Whether Ellipsis is enabled for this team.
      - `key` string, nullable: The team's short key (issue prefix).
      - `name` string, required: The team's display name.
    - `updated_at` string, date-time, required
  - `sentry` SentryOrganizationSummary[]: The connected Sentry organizations; empty if none are connected.
    - `integration_id` string, required: The Sentry integration id.
    - `organization_slug` string, required: The Sentry organization's slug.
  - `slack` SlackIntegrationSummary: The account's connected Slack workspace.
    - `created_at` string, date-time, required
    - `operations_channel_id` string, nullable: The channel configured as the operations channel, if one is set.
    - `team_id` string, required: The Slack workspace (team) id.
    - `team_name` string, required: The Slack workspace name.
    - `updated_at` string, date-time, required

## Other responses

- `401`: The bearer token is missing, invalid, or revoked.
- `403`: The credential may not perform this action, or the account is blocked.
- `422`: Validation Error

---

[API](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api.md) - [All operations](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ellipsis/apis/ellipsis-rest-api/revisions/344b16df9a1a?raw)