Import a Skill
Skills API
Skill importieren
Erstelle oder aktualisiere einen Skill aus einer SKILL.md-Datei oder einem Zip-Archiv
POST
Import a Skill
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach
api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/publicSKILL.md-Datei oder einem Zip-Archiv. Nutze diesen Endpoint, um repository-verwaltete Skills in Langdock zu synchronisieren.
Erforderliche Scopes
Dieser Endpoint erfordert denSKILL_API Scope.
Das Erstellen eines neuen Skills erfordert die Workspace-Berechtigung
createSkills. Das Aktualisieren eines bestehenden Skills mit mode: "upsert" erfordert Editor-Zugriff auf den passenden Skill.Request-Format
Sende die Anfrage alsmultipart/form-data.
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
file | file | Ja | SKILL.md, .zip oder .skill Dateiinhalt. |
fileType | string | Ja | Zu verwendender Datei-Parser: md oder zip. Nutze zip für .zip- und .skill-Archive. |
mode | string | Nein | Import-Modus: create oder upsert. Standard: create. |
integrationIds | string | Nein | JSON-kodiertes Array von Integration-UUIDs zum Anhängen, z. B. ["550e8400-e29b-41d4-a716-446655440000"]. |
SKILL.md-Format
Der importierte Skill muss YAML-Frontmatter gefolgt von Anweisungen enthalten:SKILL.md
| Frontmatter-Feld | Erforderlich | Beschreibung |
|---|---|---|
name | Ja | Skill-Name. Maximum: 64 Zeichen. |
slug | Nein | Stabiler Skill-Slug. Wenn ausgelassen, generiert Langdock einen aus dem Namen. |
description | Nein | Beschreibung, wann der Skill angewendet werden soll. Maximum: 1024 Zeichen. |
license | Nein | Optionale Lizenz-Metadaten. |
Zip-Archiv-Regeln
Zip-Archive müssen eineSKILL.md-Datei im Root oder in einem Top-Level-Verzeichnis enthalten. Langdock speichert erlaubte unterstützende Dateien mit dem Skill und überspringt nicht unterstützte Dateitypen.
| Limit | Wert |
|---|---|
| Upload-Größe | 25 MB |
| Gesamtgröße unkomprimiert | 20 MB |
| Einzeldateigröße | 5 MB |
| Dateien pro Archiv | 200 |
Import-Modi
| Modus | Verhalten |
|---|---|
create | Erstellt einen neuen Skill aus dem Import. Die Anfrage schlägt fehl, wenn der Slug bereits existiert. |
upsert | Aktualisiert einen bearbeitbaren Skill mit demselben Slug oder erstellt einen neuen Skill, wenn keiner existiert. Die Anfrage schlägt fehl, wenn mehrere bearbeitbare Skills denselben Slug verwenden. |
Beispiel
Antwortformat
Erfolgsantwort (200 OK oder 201 Created)
200 OK bedeutet, dass ein bestehender Skill per upsert aktualisiert wurde. 201 Created bedeutet, dass ein neuer Skill erstellt wurde.
Fehlerbehandlung
| Statuscode | Beschreibung |
|---|---|
| 400 | Ungültige Form-Daten, ungültige SKILL.md, ungültiges Zip-Archiv oder nicht zugängliche integrationIds |
| 401 | Ungültiger oder fehlender API Key |
| 403 | Fehlender SKILL_API Scope, kein Skills-Produktzugriff, keine Erstellberechtigung oder kein Editor-Zugriff |
| 409 | Bestehender Slug-Konflikt oder mehrdeutiger Upsert-Slug |
| 413 | Hochgeladene Datei ist zu groß |
| 429 | Rate Limit überschritten |
| 500 | Interner Serverfehler |
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.
Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
multipart/form-data
SKILL.md, .zip, or .skill file content.
File parser to use.
Verfügbare Optionen:
md, zip Whether to create a Skill or update an editable Skill with the same slug.
Verfügbare Optionen:
create, upsert JSON-encoded array of integration UUIDs.