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

# List Integrations Route

`GET /api/integrations/`

Lists integrations for a given knowledge base.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- union[]
  - union
    - S3V0Integration — S3 integration model.
      - `id` string, uuid, required
      - `integration_category` 'rbac' | 'oauth'
      - `integration_type` 's3/v0' | 'gcs/v0' | 'notion/v0' | 'slack/v0'
      - `state` 'ready' | 'pending' | 'error', required
      - `principal_id` string, required
      - `resource_access_definition` S3ResourceV0AccessDefinition, required
        - `resource` S3ResourceV0, required
          - `resource_type` 's3/v0'
          - `bucket_name` string, required
          - `prefix` string, required
        - `policy` object, required
    - GCSV0Integration — GCS integration model.
      - `id` string, uuid, required
      - `integration_category` 'rbac' | 'oauth'
      - `integration_type` 's3/v0' | 'gcs/v0' | 'notion/v0' | 'slack/v0'
      - `state` 'ready' | 'pending' | 'error', required
      - `principal_id` string, required
      - `resource_access_definition` GCSResourceV0AccessDefinition, required
        - `resource` GCSResourceV0, required
          - `resource_type` 'gcs/v0'
    - NotionV0Integration — Notion integration model.
      - `id` string, uuid, required
      - `integration_category` 'rbac' | 'oauth'
      - `integration_type` 's3/v0' | 'gcs/v0' | 'notion/v0' | 'slack/v0'
      - `state` 'ready' | 'pending' | 'error', required
      - `token` union, required
        - NotionAccessToken
          - `integration_type` 'notion/v0'
          - `access_token` string, required
          - `bot_id` string, required
          - `owner` object, required
          - `workspace_id` string, required
        - SlackAccessToken
          - `integration_type` 'slack/v0'
          - `access_token` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-12-05** `df1d1cc9e050` — 4 info
  - removed the `gcs/v0` enum value from the `items/oneOf[subschema #2: GCSV0Integration]/resource_access_definition/resource/resource_type` response property for the response status `200`
  - removed the `notion/v0` enum value from the `items/oneOf[subschema #3: NotionV0Integration]/token/anyOf[subschema #1: NotionAccessToken]/integration_type` response property for the response status `200`
  - removed the `s3/v0` enum value from the `items/oneOf[subschema #1: S3V0Integration]/resource_access_definition/resource/resource_type` response property for the response status `200`
  - removed the `slack/v0` enum value from the `items/oneOf[subschema #3: NotionV0Integration]/token/anyOf[subschema #2: SlackAccessToken]/integration_type` response property for the response status `200`
- **2024-12-03** `c3d745f0888a` — 3 breaking, 6 warning
  - the `integration_category` response property const value `rbac` was removed for the status `200`
  - the `integration_category` response property const value `rbac` was removed for the status `200`
  - added `#/components/schemas/NotionV0Integration` to the `items/` response property `oneOf` list for the response status `200`
  - added the new `notion/v0` enum value to the `items/oneOf[subschema #1: S3V0Integration]/integration_type` response property for the response status `200`
  - …5 more
- **2024-11-04** `4abd340ba528` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cleanlab/apis/agility/changes/api/integrations/get.md)

---

[API](https://skmtc.dev/cleanlab/apis/agility.md) · [All operations](https://skmtc.dev/cleanlab/apis/agility/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cleanlab/agility/revisions/9e6009a931b6/schema)