> ## 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.

# Prompt Library API Übersicht

> Erstelle und verwalte Prompts und Prompt-Ordner in deinem Langdock Workspace programmatisch

Die Prompt Library API ermöglicht es dir, Prompts und Prompt-Ordner programmatisch zu verwalten. Nutze sie, um Prompts aus einem Repository zu synchronisieren, Vorlagen in größerer Menge zu aktualisieren und Ordner-Freigaben an deinen Content-Workflow anzupassen.

## Basis-URL

```
https://api.langdock.com
```

<Warning>
  **Dedicated Deployments**

  Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.
</Warning>

## API Key Scope

Alle Prompt-Library-API-Endpoints erfordern einen API Key mit dem `PROMPT_API` Scope.

<Tip>
  Erstelle einen API Key mit dem `PROMPT_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 Prompt-Library-Zugriffs und seiner Freigabe-Berechtigungen.
</Tip>

## Verfügbare Endpoints

| Methode  | Endpoint                         | Beschreibung                                                           |
| -------- | -------------------------------- | ---------------------------------------------------------------------- |
| `GET`    | `/prompts/v1`                    | [Prompts auflisten](/de/developer/prompts-api/list-prompts)            |
| `POST`   | `/prompts/v1`                    | [Prompt erstellen](/de/developer/prompts-api/create-prompt)            |
| `GET`    | `/prompts/v1/{promptId}`         | [Prompt abrufen](/de/developer/prompts-api/get-prompt)                 |
| `PATCH`  | `/prompts/v1/{promptId}`         | [Prompt aktualisieren](/de/developer/prompts-api/update-prompt)        |
| `DELETE` | `/prompts/v1/{promptId}`         | [Prompt löschen](/de/developer/prompts-api/delete-prompt)              |
| `GET`    | `/prompts/v1/folders`            | [Prompt-Ordner auflisten](/de/developer/prompts-api/list-folders)      |
| `POST`   | `/prompts/v1/folders`            | [Prompt-Ordner erstellen](/de/developer/prompts-api/create-folder)     |
| `GET`    | `/prompts/v1/folders/{folderId}` | [Prompt-Ordner abrufen](/de/developer/prompts-api/get-folder)          |
| `PATCH`  | `/prompts/v1/folders/{folderId}` | [Prompt-Ordner aktualisieren](/de/developer/prompts-api/update-folder) |
| `DELETE` | `/prompts/v1/folders/{folderId}` | [Prompt-Ordner löschen](/de/developer/prompts-api/delete-folder)       |

## Prompt-Objekt

Prompt-Endpoints geben dasselbe Prompt-Objekt zurück:

```typescript theme={null}
{
  id: string;
  title: string;
  prompt: string;
  createdBy: string | null;
  promptFolderId: string | null;
  sharedWithWorkspace: boolean;
  createdAt: string | null;
  updatedAt: string | null;
}
```

## Ordner-Objekt

Ordner-Endpoints geben dasselbe Ordner-Objekt zurück:

```typescript theme={null}
{
  id: string;
  name: string;
  createdBy: string;
  sharedWithWorkspace: boolean;
  sharedWithGroupId: string | null;
  createdAt: string;
  updatedAt: string;
}
```

## Berechtigungen

Anfragen nutzen den User, der den API Key erstellt hat, für Berechtigungen und Zugriff:

| Aktion                             | Erforderlicher Zugriff                                                                 |
| ---------------------------------- | -------------------------------------------------------------------------------------- |
| Prompts auflisten oder abrufen     | Zugriff über Besitz, Workspace-Freigabe oder einen geteilten Ordner                    |
| Prompts erstellen                  | Aktive Workspace-Mitgliedschaft                                                        |
| Prompts aktualisieren oder löschen | Ersteller, Workspace-Editor oder Gruppen-Editor des Prompt-Ordners                     |
| Prompt mit dem Workspace teilen    | `sharePrompts` Berechtigung                                                            |
| Ordner auflisten oder abrufen      | Zugriff über Besitz, Workspace-Freigabe oder Gruppen-Freigabe                          |
| Ordner erstellen                   | Aktive Workspace-Mitgliedschaft                                                        |
| Ordner aktualisieren               | Ersteller, Workspace-Editor, `sharePrompts` bei Workspace-Freigabe oder Gruppen-Editor |
| Ordner löschen                     | Ersteller, Workspace-Editor oder Gruppen-Editor                                        |

Ein Prompt kann nicht gleichzeitig mit dem Workspace geteilt und einem Ordner zugewiesen sein. Ein Ordner kann nicht gleichzeitig mit dem Workspace und einer Gruppe geteilt sein. Das Löschen eines Ordners löscht auch die Prompts darin.

Private Ordner bleiben nur für den Ersteller zugänglich. Die Workspace-Freigabe von Ordnern nutzt die `sharePrompts` Berechtigung oder Workspace-Editor-Zugriff.

## Rate Limits

Die Prompt Library 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>