---
title: "Get Integration Route"
method: GET
path: "/api/integrations/{integration_id}"
tags: ["integration"]
---

# Get Integration Route

`GET /api/integrations/{integration_id}`

Gets an integration.

## Path parameters

- `integration_id` string, uuid, required

## Response `200`

Successful Response

- 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 `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 `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 `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 `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
  - added `#/components/schemas/NotionV0Integration` to the response body `oneOf` list for the response status `200`
  - 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 the new `notion/v0` enum value to the `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/:integration_id/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)