Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
Aktualisiert die Eigenschaften einer bestehenden Integration. Gib nur die Felder an, die du ändern möchtest.
Erforderliche Scopes
Dieser Endpoint erfordert den INTEGRATION_API Scope.
Pfad-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
integrationId | string | Ja | UUID der Integration |
Request Body
Alle Felder sind optional. Füge nur die Felder hinzu, die du aktualisieren möchtest.
| Parameter | Typ | Beschreibung |
|---|
name | string | Integrationsname (max. 40 Zeichen) |
description | string | Integrationsbeschreibung (max. 90 Zeichen) |
iconUrl | string | URL zum Integrations-Icon |
color | string | Hex-Farbcode für die Integration |
Beispiel
const axios = require("axios");
async function updateIntegration(integrationId) {
const response = await axios.patch(
`https://api.langdock.com/integrations/v1/${integrationId}`,
{
name: "Updated Integration Name",
description: "New description for the integration"
},
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
}
);
console.log("Updated integration:", response.data.integration);
}
updateIntegration("550e8400-e29b-41d4-a716-446655440000");
Erfolgreiche Antwort (200 OK)
{
integration: {
id: string;
name: string;
description: string;
};
}
Fehlerbehandlung
| Status Code | Beschreibung |
|---|
| 400 | Ungültiger Request Body oder ungültige Integration-ID |
| 401 | Ungültiger oder fehlender API-Schlüssel |
| 403 | Kein Zugriff auf diese Integration |
| 404 | Integration nicht gefunden |
| 429 | Rate Limit überschritten |
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.