Bevor du startest
- API-Key-Scope: Erfordert einen Workspace-API-Schlüssel mit dem
KNOWLEDGE_FOLDER_APIScope. Ein Schlüssel, der diesen Scope schon hat, kann diesen Endpoint aufrufen. Persönliche Schlüssel werden auch mit diesem Scope abgelehnt. Der Besitzer des Schlüssels braucht die Berechtigung Dateien hochladen. Siehe Wissensdatenbanken mit der API teilen für die Einrichtung. - Wissensdatenbanken: Die Knowledge Folder API verwaltet Ressourcen, die in der Library als Wissensdatenbanken erscheinen.
Basis-URL
Anfrageformat
Dieser Endpoint akzeptiertapplication/json.
Request Body
Unbekannte Felder werden abgelehnt. Es gibt keinen öffentlichen Endpoint, um eine Wissensdatenbank zu löschen.
Beispiele
Erstellen mit cURL
Erstellen mit JavaScript
Antwortformat
Erfolgreiche Antwort (201 Created)
role ist EDITOR, und fileCount ist 0. Du kannst Dateien hochladen, aktualisieren und löschen, die Wissensdatenbank umbenennen und Zugriff teilen, ohne sie vorher mit dem Schlüssel zu teilen.
Beispielantwort
Fehlerbehandlung
Ein leerer Name, ein Feld über 2000 Zeichen oder ein unbekanntes Feld liefert
400 mit "Invalid request".
Ein persönlicher Schlüssel liefert 403 mit "This API key cannot create knowledge folders."
Fehlt dem Besitzer Dateien hochladen, ist die Antwort 403 mit "This API key's owner does not have permission to upload documents."
Fehlt der Scope, ist die Antwort 403 mit error INSUFFICIENT_SCOPES.
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.