List Integrations

Retrieve private API, MCP, and A2A integrations shared with your API key

Returns private API, MCP, and A2A integrations that are explicitly shared with the API key. Public Langdock integrations are not included.

Base URL

https://api.langdock.com/integrations/v1/get

Dedicated deployments

Replace api.langdock.com with <your-deployment-url>/api/public in all requests.

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
    iconUrl: string | null;  // Absolute icon URL, or null if none is set
    authType: string;        // Authentication type (e.g., "OAUTH", "API_KEY", "NONE")
    buildByLangdock: boolean; // Always false. This endpoint does not return public Langdock integrations
    integrationType: string; // "API", "MCP", or "A2A"
    serverUrl: string | null; // MCP server URL when integrationType is "MCP", otherwise null
    agentCardUrl: string | null; // A2A agent card URL when integrationType is "A2A", otherwise null
    actions: Array<{
      id: string;            // UUID of the action
      name: string;          // Action display name
      description: string;   // Action description
      kind: string;          // "VIEW", "CHANGE", or "DELETE"
      requiresConfirmation: boolean; // Default confirmation setting on the action
    }>;
  }>;
}

Example Response

{
  "integrations": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "name": "My Custom Integration",
      "description": "Internal API connector",
      "iconUrl": null,
      "authType": "API_KEY",
      "buildByLangdock": false,
      "integrationType": "API",
      "serverUrl": null,
      "agentCardUrl": null,
      "actions": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440001",
          "name": "Get User Data",
          "description": "Retrieves user information",
          "kind": "VIEW",
          "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.