Skills API Übersicht

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

Methode	Endpoint	Beschreibung
`GET`	`/skills/v1`	Skills auflisten
`POST`	`/skills/v1`	Skill erstellen
`GET`	`/skills/v1/{skillId}`	Skill abrufen
`PATCH`	`/skills/v1/{skillId}`	Skill aktualisieren
`DELETE`	`/skills/v1/{skillId}`	Skill löschen
`POST`	`/skills/v1/import`	Skill 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:

Aktion	Erforderlicher Zugriff
Skills auflisten oder abrufen	Viewer-Zugriff auf den Skill
Skills erstellen oder per Import anlegen	`createSkills` Workspace-Berechtigung
Skills aktualisieren oder per Import upserten	Editor-Zugriff auf den Skill
Skills löschen	Owner-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.

Trigger löschen Skills auflisten

⌘I

​API Key Scope

​Verfügbare Endpoints

​Skill-Objekt

​Unterstützte Skill-Typen

​Berechtigungen

​Rate Limits

API Key Scope

Verfügbare Endpoints

Skill-Objekt

Unterstützte Skill-Typen

Berechtigungen

Rate Limits