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

# Wissensdatenbanken auflisten

> Liste die Wissensdatenbanken, die ein Workspace-API-Schlüssel bereits nutzen kann

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](/de/developer/knowledge-folder-api/sharing) für die Einrichtung.
* **Wissensdatenbanken**: Die Knowledge Folder API verwaltet Ressourcen, die in der Library als Wissensdatenbanken erscheinen.

## Basis-URL

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

<Warning>
  **Dedicated Deployments**

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

## 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](/de/developer/knowledge-folder-api/retrieve-files).

## Beispiele

### Wissensdatenbanken mit cURL auflisten

```bash theme={null}
curl -X GET "https://api.langdock.com/knowledge?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Wissensdatenbanken mit JavaScript auflisten

```javascript theme={null}
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)

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

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

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


## OpenAPI

````yaml get /knowledge
openapi: 3.0.0
info:
  title: Langdock API
  version: 3.0.0
servers:
  - url: https://api.langdock.com
    description: Production
security:
  - bearerAuth: []
paths:
  /knowledge:
    get:
      summary: List Knowledge bases accessible to the API key
      parameters:
        - name: limit
          in: query
          required: false
          description: Number of Knowledge bases to return. Default 50. Maximum 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
        - name: cursor
          in: query
          required: false
          description: UUID of the last Knowledge base from the previous page
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Knowledge bases retrieved successfully
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````