Zum Hauptinhalt springen
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
Erstellt eine neue benutzerdefinierte Integration in deinem Workspace. Nach der Erstellung kannst du Actions und Triggers zur Integration hinzufügen.

Erforderliche Scopes

Dieser Endpoint erfordert den INTEGRATION_API Scope.

Request-Parameter

ParameterTypErforderlichBeschreibung
namestringJaIntegrationsname (max. 40 Zeichen)
descriptionstringNeinIntegrationsbeschreibung (max. 90 Zeichen)

Beispiel

const axios = require("axios");

async function createIntegration() {
  const response = await axios.post(
    "https://api.langdock.com/integrations/v1/create",
    {
      name: "My Custom Integration",
      description: "Connects to my internal company API for data retrieval"
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Created integration:", response.data.integration);
  return response.data.integration.id;
}

createIntegration();

Antwortformat

Erfolgreiche Antwort (201 Created)

{
  integration: {
    id: string;          // UUID der erstellten Integration
    name: string;        // Integrationsname
    description: string; // Integrationsbeschreibung
    createdAt: string;   // ISO 8601 Zeitstempel
  };
}

Beispielantwort

{
  "integration": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My Custom Integration",
    "description": "Connects to my internal company API for data retrieval",
    "createdAt": "2025-02-18T10:30:00.000Z"
  }
}

Fehlerbehandlung

Status CodeBeschreibung
400Ungültiger Request Body (Name zu lang, ungültige Zeichen)
401Ungültiger oder fehlender API-Schlüssel
429Rate Limit überschritten
500Interner Serverfehler

Nächste Schritte

Nach dem Erstellen einer Integration wirst du typischerweise Folgendes tun:
  1. Actions hinzufügen, die Agents ausführen können
  2. Triggers hinzufügen, die Workflows oder Konversationen starten
  3. Authentifizierung konfigurieren, falls deine Integration dies erfordert
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.