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

# List integration connections

`GET /integrations/connections`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/integrations/connections`
- Auth: none declared

List integration connections and their connection state for the organization.

## Query parameters

- `organizationId` string: Organization to list connections for. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).
- `provider` 'slack' | 'github' | 'linear' | 'pagerduty' | 'victorops' | 'rootly' | 'incident_io' | 'webhook' | 'teams' | 'bitbucket' | 'jira' | 'gitcafe': Filter connections by provider.

## Response `200`

OK

- object
  - `connections` object[], required
    - `connectionStatus` object
      - `state` 'connected' | 'needs_attention' | 'connecting' | 'not_connected', required
      - `reasonCode` 'credentials_rejected' | 'permissions_missing' | 'configuration_invalid' | 'discovery_failed' | 'health_check_failed' | 'stream_failed' | 'recovery_required', nullable, required
      - `checkedAt` string, date-time, nullable, required
      - `verification` 'verified' | 'unverified', required
    - `recovery` object
      - `action` 'reconnect' | 'update_credentials' | 'manage_installation' | 'manage_owner' | 'review_setup', nullable, required
      - `canCheck` boolean, required
      - `canDisconnect` boolean, required
      - `target` object
        - `kind` 'integration' | 'connected_account' | 'mcp_connector' | 'log_source' | 'sandbox_cli', required
        - `resourceId` string, required
        - `providerId` string, required
        - `scope` object, required
          - `kind` 'user' | 'organization' | 'project', required
          - `id` string, required
    - `id` string, uuid, required
    - `provider` 'slack' | 'github' | 'linear' | 'pagerduty' | 'victorops' | 'rootly' | 'incident_io' | 'webhook' | 'teams' | 'bitbucket' | 'jira' | 'gitcafe', required
    - `displayName` string, nullable, required
    - `status` 'pending' | 'connected' | 'error' | 'revoked', required
    - `isActive` boolean, required: Whether this connection counts as connected (status 'connected' or 'error'). An error-status connection is the organization's connection — broken, not absent.
    - `needsAttention` boolean, required: Whether the connection should surface a reconnect prompt (status 'error' or health status 'unhealthy').
    - `metadata` object, required: Non-secret provider metadata (e.g. workspace/team names).
    - `healthStatus` 'healthy' | 'unhealthy' | 'unknown', required
    - `healthMessage` string, nullable, required
    - `healthCheckedAt` string, date-time, nullable, required
    - `healthConsecutiveFailures` integer, required
    - `connectedBy` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Changes

- **2026-10-15** `6853a8959e9c`: 1 warning, 1 info
  - added the new `gitcafe` enum value to the `connections/items/provider` response property for the response status `200`
  - added the new enum value `gitcafe` to the `query` request parameter `provider`
- **2026-09-17** `9be5c4da3dc5`: 2 info
  - added the optional property `connections/items/connectionStatus` to the response with the `200` status
  - added the optional property `connections/items/recovery` to the response with the `200` status

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/integrations/connections/get.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)