Prompt Library API Übersicht

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

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

API Key Scope

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

Erstelle einen API Key mit dem PROMPT_API Scope in deinen Workspace-Einstellungen. Die API agiert als der User, der den Key erstellt hat – inklusive seines Prompt-Library-Zugriffs und seiner Freigabe-Berechtigungen.

Verfügbare Endpoints

Methode	Endpoint	Beschreibung
`GET`	`/prompts/v1`	Prompts auflisten
`POST`	`/prompts/v1`	Prompt erstellen
`GET`	`/prompts/v1/{promptId}`	Prompt abrufen
`PATCH`	`/prompts/v1/{promptId}`	Prompt aktualisieren
`DELETE`	`/prompts/v1/{promptId}`	Prompt löschen
`GET`	`/prompts/v1/folders`	Prompt-Ordner auflisten
`POST`	`/prompts/v1/folders`	Prompt-Ordner erstellen
`GET`	`/prompts/v1/folders/{folderId}`	Prompt-Ordner abrufen
`PATCH`	`/prompts/v1/folders/{folderId}`	Prompt-Ordner aktualisieren
`DELETE`	`/prompts/v1/folders/{folderId}`	Prompt-Ordner löschen

Prompt-Objekt

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

{
  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:

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

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.

⌘I

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API