List Integrations

Retrieve all integrations available in your workspace

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

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

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)

{
  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
      requiresConfirmation: boolean; // Whether the action requires user confirmation before running
    }>;
  }>;
}

Example Response

{
  "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",
          "requiresConfirmation": true
        },
        {
          "id": "660e8400-e29b-41d4-a716-446655440002",
          "name": "Create Channel",
          "description": "Create a new Slack channel",
          "requiresConfirmation": true
        }
      ]
    },
    {
      "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",
          "requiresConfirmation": false
        }
      ]
    }
  ]
}

Error Handling

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

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.