> ## Documentation Index
> Fetch the complete documentation index at: https://docs.app.strix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Connect and manage source control integrations

export const ScarfPixel = () => <img referrerPolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=831669b6-b4bd-42cb-8832-2122c03e1d5f" alt="" width="1" height="1" style={{
  position: "absolute",
  width: 0,
  height: 0,
  opacity: 0,
  pointerEvents: "none"
}} />;

<ScarfPixel />

List connected integrations and connect GitLab or Bitbucket via personal access token. GitHub App and Slack installs use interactive OAuth flows and are managed from the dashboard.

## List integrations

```bash theme={null}
curl -X GET "https://app.strix.ai/api/v1/integrations" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

**Required scope:** `integrations:read`

## Validate a token

Validate a token before connecting (does not persist anything):

```bash theme={null}
curl -X POST "https://app.strix.ai/api/v1/integrations/gitlab/validate" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"token": "<GITLAB_PAT>", "instance_url": "https://gitlab.example.com"}'
```

**Required scope:** `integrations:write`

## Connect via token

```bash theme={null}
curl -X POST "https://app.strix.ai/api/v1/integrations/gitlab/connect" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"token": "<GITLAB_PAT>", "instance_url": "https://gitlab.example.com"}'
```

For Bitbucket, use the `bitbucket` endpoints and pass `workspace`:

```bash theme={null}
curl -X POST "https://app.strix.ai/api/v1/integrations/bitbucket/connect" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"token": "<BITBUCKET_APP_PASSWORD>", "workspace": "my-workspace"}'
```

**Required scope:** `integrations:write`

## Disconnect an integration

```bash theme={null}
curl -X DELETE "https://app.strix.ai/api/v1/integrations/<PROVIDER>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
```

`<PROVIDER>` is one of `github`, `gitlab`, `bitbucket`, or `slack`.

**Required scope:** `integrations:write`