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

# List Integrations

> Retrieve all integrations available in your workspace

<Info>
  **Using our API via a dedicated deployment?** Just replace `api.langdock.com` with your deployment's base URL: **`<deployment-url>/api/public`**
</Info>

Returns all integrations available in your workspace, including both Langdock-built integrations and custom integrations you've created.

## Required Scopes

This endpoint requires one of the following API key scopes:

* `ASSISTANT_API`
* `INTEGRATION_API`

## Example

```javascript theme={null}
const axios = require("axios");

async function listIntegrations() {
  const response = await axios.get(
    "https://api.langdock.com/integrations/v1/get",
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Integrations:", response.data.integrations);
}

listIntegrations();
```

## Response Format

### Success Response (200 OK)

```typescript theme={null}
{
  integrations: Array<{
    id: string;              // UUID of the integration
    name: string;            // Display name
    description: string;     // Integration description
    authType: string;        // Authentication type (e.g., "OAUTH", "API_KEY", "NONE")
    buildByLangdock: boolean; // true if this is a Langdock-built integration
    actions: Array<{
      id: string;            // UUID of the action
      name: string;          // Action display name
      description: string;   // Action description
    }>;
  }>;
}
```

## Example Response

```json theme={null}
{
  "integrations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Slack",
      "description": "Send messages and interact with Slack",
      "authType": "OAUTH",
      "buildByLangdock": true,
      "actions": [
        {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "name": "Send Message",
          "description": "Send a message to a Slack channel"
        },
        {
          "id": "660e8400-e29b-41d4-a716-446655440002",
          "name": "Create Channel",
          "description": "Create a new Slack channel"
        }
      ]
    },
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "name": "My Custom Integration",
      "description": "Internal API connector",
      "authType": "API_KEY",
      "buildByLangdock": false,
      "actions": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440001",
          "name": "Get User Data",
          "description": "Retrieves user information"
        }
      ]
    }
  ]
}
```

## Error Handling

| Status Code | Description                |
| ----------- | -------------------------- |
| 401         | Invalid or missing API key |
| 429         | Rate limit exceeded        |
| 500         | Internal server error      |

<Info>
  Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>