> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills API Übersicht

> Erstelle, importiere und verwalte Skills in deinem Langdock Workspace programmatisch

<Info>
  **Nutzt du unsere API über ein Dedicated Deployment?** Ersetze einfach `api.langdock.com` mit der Basis-URL deines Deployments: **`<deployment-url>/api/public`**
</Info>

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.

<Tip>
  Erstelle einen API Key mit dem `SKILL_API` Scope in deinen [Workspace-Einstellungen](https://app.langdock.com/settings/workspace/api-keys). Die API agiert als der User, der den Key erstellt hat – inklusive seines Skills-Produktzugriffs und seiner Skill-Berechtigungen.
</Tip>

## Verfügbare Endpoints

| Methode  | Endpoint               | Beschreibung                                                 |
| -------- | ---------------------- | ------------------------------------------------------------ |
| `GET`    | `/skills/v1`           | [Skills auflisten](/de/developer/skills-api/list-skills)     |
| `POST`   | `/skills/v1`           | [Skill erstellen](/de/developer/skills-api/create-skill)     |
| `GET`    | `/skills/v1/{skillId}` | [Skill abrufen](/de/developer/skills-api/get-skill)          |
| `PATCH`  | `/skills/v1/{skillId}` | [Skill aktualisieren](/de/developer/skills-api/update-skill) |
| `DELETE` | `/skills/v1/{skillId}` | [Skill löschen](/de/developer/skills-api/delete-skill)       |
| `POST`   | `/skills/v1/import`    | [Skill importieren](/de/developer/skills-api/import-skill)   |

## Skill-Objekt

Skills-API-Antworten verwenden dasselbe Skill-Objekt über alle Endpoints hinweg:

```typescript theme={null}
{
  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.

<Info>
  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](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>