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
Die Skills API ermöglicht es dir, Skills programmatisch zu verwalten. Nutze sie, um Skills aus einem Repository zu synchronisieren, wiederverwendbare Anweisungen zu erstellen, zugängliche Integrationen anzubinden und SKILL.md-Dateien oder Zip-Archive zu importieren.

​
API Key Scope

Alle Skills-API-Endpoints erfordern einen API Key mit dem SKILL_API Scope.
Erstelle einen API Key mit dem SKILL_API Scope in deinen Workspace-Einstellungen. Die API agiert als der User, der den Key erstellt hat – inklusive seines Skills-Produktzugriffs und seiner Skill-Berechtigungen.

​
Verfügbare Endpoints

MethodeEndpointBeschreibung
GET/skills/v1Skills auflisten
POST/skills/v1Skill erstellen
GET/skills/v1/{skillId}Skill abrufen
PATCH/skills/v1/{skillId}Skill aktualisieren
DELETE/skills/v1/{skillId}Skill löschen
POST/skills/v1/importSkill importieren

​
Skill-Objekt

Skills-API-Antworten verwenden dasselbe Skill-Objekt über alle Endpoints hinweg: 
{
  id: string;
  name: string;
  slug: string;
  description: string;
  instructions: string;
  integrationIds: string[];
  createdAt: string;
  updatedAt: string;
}

​
Unterstützte Skill-Typen

Die API verwaltet nur Skills, die User im Workspace erstellen. System Skills, Templates und Skill Packs werden über diese Endpoints weder zurückgegeben noch geändert. Für einzelne Endpoints verwende die Skill-id. Das Feld slug wird als Listenfilter und als Key für Upserts per Import unterstützt. Für Abrufen, Aktualisieren und Löschen verwendest du jedoch skillId.

​
Berechtigungen

Anfragen nutzen den User, der den API Key erstellt hat, für Berechtigungen und Zugriff:
AktionErforderlicher Zugriff
Skills auflisten oder abrufenViewer-Zugriff auf den Skill
Skills erstellen oder per Import anlegencreateSkills Workspace-Berechtigung
Skills aktualisieren oder per Import upsertenEditor-Zugriff auf den Skill
Skills löschenOwner-Zugriff auf den Skill oder Admin-Zugriff
Wenn du Integrationen mit integrationIds anbindest, muss jede Integration in deinem Workspace aktiviert sein.

​
Rate Limits

Die Skills API folgt den Standard-API-Rate-Limits. Wenn du das Limit überschreitest, erhältst du eine 429-Antwort. Warte und versuche es mit exponentiellem Backoff erneut.
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.