Skills API Übersicht

Die Skills API ermöglicht es dir, Skills programmatisch zu verwalten. Nutze sie, um Skills aus einem Repository zu synchronisieren, gespeicherte Dateien zu prüfen, wiederverwendbare Anweisungen zu erstellen, zugängliche Integrationen anzubinden und SKILL.md-Dateien oder Zip-Archive zu importieren.

Basis-URL

https://api.langdock.com

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen. Skills-API-Anfragen agieren weiterhin als der User, der den Key erstellt hat. Wenn du einen Skill mit einem Workspace-API-Key teilst, ändert das nicht, welche Skills der Key sieht.

API Key Scope

Alle Skills-API-Endpoints erfordern einen API Key mit dem SKILL_API Scope.

Erstelle einen Workspace-API-Key mit dem SKILL_API Scope in deinen Workspace-Einstellungen. Persönliche API-Keys können diese API nicht aufrufen. Anfragen nutzen den User, dem der Key gehört, für den Skills-Produktzugriff und die Skill-Berechtigungen.

Verfügbare Endpoints

Methode	Endpoint	Beschreibung
`GET`	`/skills/v1`	Skills auflisten
`POST`	`/skills/v1`	Skill erstellen
`GET`	`/skills/v1/{skillId}`	Skill abrufen
`GET`	`/skills/v1/{skillId}/files`	Skill-Datei 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;
}

Skill abrufen gibt zusätzlich ein files-Array mit Metadaten zu gespeicherten Dateien zurück. Antworten von Auflisten, Erstellen und Aktualisieren enthalten files nicht.

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, dem der Key gehört, für Berechtigungen und Zugriff:

Aktion	Erforderlicher Zugriff
Skills auflisten oder abrufen, inklusive Dateien	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.

Skill-Sichtbarkeit

Ein Workspace-API-Key kann Skills auflisten und abrufen, die er selbst angelegt hat, die mit dem Workspace geteilt sind, und die ein Workspace-Admin mit diesem Key geteilt hat. Workspace-Admins vergeben diesen Zugriff in Teilen.

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.

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow-Ausführungs-Export-API

User Management API

Audit Logs API

Skills API Übersicht

Basis-URL

API Key Scope

Verfügbare Endpoints

Skill-Objekt

Unterstützte Skill-Typen

Berechtigungen

Skill-Sichtbarkeit

Rate Limits

​Basis-URL

​API Key Scope

​Verfügbare Endpoints

​Skill-Objekt

​Unterstützte Skill-Typen

​Berechtigungen

​Skill-Sichtbarkeit

​Rate Limits

Basis-URL

API Key Scope

Verfügbare Endpoints

Skill-Objekt

Unterstützte Skill-Typen

Berechtigungen

Skill-Sichtbarkeit

Rate Limits