Create a Skill
Skills API
Skill erstellen
Erstelle einen neuen Skill in deinem Workspace
POST
Create a Skill
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach
api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/publicErforderliche Scopes
Dieser Endpoint erfordert denSKILL_API Scope.
Erfordert die Workspace-Berechtigung
createSkills.Request-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Skill-Name. Maximum: 64 Zeichen. |
slug | string | Nein | Stabiler Skill-Slug. Nur Kleinbuchstaben, Zahlen und Bindestriche. Maximum: 100 Zeichen. |
description | string | Nein | Beschreibung, wann der Skill angewendet werden soll. Maximum: 1024 Zeichen. |
instructions | string | Ja | Skill-Anweisungen. Maximum: 50000 Zeichen. |
integrationIds | string[] | Nein | Integration-UUIDs, die an den Skill angehängt werden. Jede Integration muss in deinem Workspace aktiviert sein. |
Beispiel
Antwortformat
Erfolgsantwort (201 Created)
Fehlerbehandlung
| Statuscode | Beschreibung |
|---|---|
| 400 | Ungültiger Request Body oder nicht zugängliche integrationIds |
| 401 | Ungültiger oder fehlender API Key |
| 403 | Fehlender SKILL_API Scope, kein Skills-Produktzugriff oder keine Erstellberechtigung |
| 409 | Skill-Slug-Konflikt |
| 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
application/json
Skill name.
Required string length:
1 - 64Skill instructions.
Required string length:
1 - 50000Stable Skill slug.
Maximum string length:
100Pattern:
^[a-z0-9-]+$Description used to explain when the Skill should apply.
Maximum string length:
1024Integration IDs to attach to the Skill.
Antwort
Skill created successfully