Wissensdatenbanken auflisten

List Knowledge bases accessible to the API key

curl --request GET \
  --url https://api.langdock.com/knowledge \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.langdock.com/knowledge', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.langdock.com/knowledge",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.langdock.com/knowledge"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.langdock.com/knowledge")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

knowledge

List Knowledge bases accessible to the API key

curl --request GET \
  --url https://api.langdock.com/knowledge \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.langdock.com/knowledge', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.langdock.com/knowledge",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.langdock.com/knowledge"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.langdock.com/knowledge")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Listet die Wissensdatenbanken, die der API-Schlüssel bereits nutzen kann. Nutze diesen Endpoint, um IDs, Namen, Rollen und Dateianzahlen zu finden, bevor du hochlädst, suchst oder Zugriff verwaltest.

Bevor du startest

API-Key-Scope: Erfordert einen API-Schlüssel mit dem KNOWLEDGE_FOLDER_API Scope. Nur Workspace-API-Schlüssel erhalten Wissensdatenbanken in dieser Liste. Persönliche Schlüssel liefern eine leere Liste. 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

https://api.langdock.com

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

Anfrageformat

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
`limit`	integer	Nein	Anzahl der Wissensdatenbanken. Standard: `50`. Minimum: `1`. Maximum: `100`.
`cursor`	string	Nein	UUID der letzten Wissensdatenbank der vorherigen Seite.

Dieser Endpoint listet Wissensdatenbanken, keine Dateien. Dateien in einer Wissensdatenbank listest du mit Dateien aus Wissensdatenbank abrufen.

Beispiele

Wissensdatenbanken mit cURL auflisten

curl -X GET "https://api.langdock.com/knowledge?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Wissensdatenbanken mit JavaScript auflisten

const axios = require("axios");

async function listKnowledgeBases(cursor) {
  const response = await axios.get("https://api.langdock.com/knowledge", {
    params: {
      limit: 50,
      cursor,
    },
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  });

  return response.data;
}

const firstPage = await listKnowledgeBases();
console.log(`Found ${firstPage.result.folders.length} Knowledge bases`);

firstPage.result.folders.forEach((folder) => {
  console.log(`- ${folder.name} (${folder.role}, ${folder.fileCount} files)`);
});

Antwortformat

Erfolgreiche Antwort (200 OK)

{
  status: "success";
  result: {
    folders: Array<{
      id: string;                 // ID der Wissensdatenbank
      name: string;               // Name der Wissensdatenbank
      description: string | null; // Beschreibung
      createdAt: string;          // ISO-8601-Zeitstempel
      updatedAt: string;          // ISO-8601-Zeitstempel
      fileCount: number;          // Nicht gelöschte Dateien
      role: "USER" | "EDITOR";    // Rolle dieses Schlüssels. USER ist Betrachter.
    }>;
    nextCursor?: string;          // Vorhanden, wenn eine weitere Seite folgt
  };
}

role ist EDITOR, wenn der Schlüssel explizit Bearbeiter ist. role ist USER, wenn der Schlüssel explizit Betrachter ist, oder wenn die Wissensdatenbank API-Suche ohne explizite Freigabe für den Schlüssel erlaubt. Die Reihenfolge ist createdAt absteigend, danach id absteigend.

Beispielantwort

{
  "status": "success",
  "result": {
    "folders": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Produkthandbuch",
        "description": "Interne Produktdokumentation",
        "createdAt": "2026-08-12T09:15:00.000Z",
        "updatedAt": "2026-08-28T14:02:00.000Z",
        "fileCount": 12,
        "role": "EDITOR"
      },
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "name": "Support-Artikel",
        "description": null,
        "createdAt": "2026-07-03T11:00:00.000Z",
        "updatedAt": "2026-08-01T16:40:00.000Z",
        "fileCount": 48,
        "role": "USER"
      }
    ],
    "nextCursor": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

Fehlerbehandlung

Status	Bedeutung
`400`	Ungültiges `limit` oder ungültiger `cursor`
`401`	Ungültiger oder fehlender API-Schlüssel
`403`	Fehlender `KNOWLEDGE_FOLDER_API` Scope
`429`	Rate Limit überschritten
`500`	Unerwarteter Serverfehler

Ein unbekannter cursor liefert 400 mit "Invalid cursor". Es gibt keinen öffentlichen Endpoint, um eine Wissensdatenbank zu erstellen oder zu löschen.

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

Authorization

string

header

erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Abfrageparameter

limit

integer

Standard:50

Number of Knowledge bases to return. Default 50. Maximum 100.

Erforderlicher Bereich: 1 <= x <= 100

cursor

string<uuid>

UUID of the last Knowledge base from the previous page

Antwort

200

Knowledge bases retrieved successfully

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow-Ausführungs-Export-API

User Management API

Audit Logs API

Wissensdatenbanken auflisten

Bevor du startest

Basis-URL

Anfrageformat

Query-Parameter

Beispiele

Wissensdatenbanken mit cURL auflisten

Wissensdatenbanken mit JavaScript auflisten

Antwortformat

Erfolgreiche Antwort (200 OK)

Beispielantwort

Fehlerbehandlung

Autorisierungen

Abfrageparameter

Antwort

​Bevor du startest

​Basis-URL

​Anfrageformat

​Query-Parameter

​Beispiele

​Wissensdatenbanken mit cURL auflisten

​Wissensdatenbanken mit JavaScript auflisten

​Antwortformat

​Erfolgreiche Antwort (200 OK)

​Beispielantwort

​Fehlerbehandlung

Autorisierungen

Abfrageparameter

Antwort

Bevor du startest

Basis-URL

Anfrageformat

Query-Parameter

Beispiele

Wissensdatenbanken mit cURL auflisten

Wissensdatenbanken mit JavaScript auflisten

Antwortformat

Erfolgreiche Antwort (200 OK)

Beispielantwort

Fehlerbehandlung