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

# Wissensdatenbank aktualisieren

> Benenne eine Wissensdatenbank um oder aktualisiere ihre Beschreibung

Aktualisiert Name oder Beschreibung einer bestehenden Wissensdatenbank. Das ist nicht der Endpoint zum Ersetzen einer Datei. Dateien ersetzt du mit [Attachment in einer Wissensdatenbank aktualisieren](/de/developer/knowledge-folder-api/update-attachment).

## Bevor du startest

* **API-Key-Scope**: Erfordert einen API-Schlüssel mit dem `KNOWLEDGE_FOLDER_API` Scope. Der API-Schlüssel selbst braucht die Rolle Bearbeiter auf der Wissensdatenbank. 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

Dieser Endpoint erwartet `application/json`.

### Pfadparameter

| Parameter  | Typ    | Pflicht | Beschreibung                |
| ---------- | ------ | ------- | --------------------------- |
| `folderId` | string | Ja      | Die ID der Wissensdatenbank |

### Request Body

| Feld          | Typ    | Pflicht | Beschreibung                             |
| ------------- | ------ | ------- | ---------------------------------------- |
| `name`        | string | Nein    | Neuer Name. Nach dem Trimmen nicht leer. |
| `description` | string | Nein    | Neue Beschreibung.                       |

Mindestens ein Feld muss gesetzt sein. Es gibt keinen öffentlichen Endpoint, um eine Wissensdatenbank zu erstellen oder zu löschen.

## Beispiele

### Aktualisieren mit cURL

```bash theme={null}
curl -X PATCH "https://api.langdock.com/knowledge/{folderId}/folder" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Produkthandbuch",
    "description": "Interne Produktdokumentation"
  }'
```

### Aktualisieren mit JavaScript

```javascript theme={null}
const axios = require("axios");

async function updateKnowledgeBase(folderId, data) {
  const response = await axios.patch(
    `https://api.langdock.com/knowledge/${folderId}/folder`,
    data,
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
    }
  );

  return response.data;
}

const result = await updateKnowledgeBase(
  "550e8400-e29b-41d4-a716-446655440000",
  { name: "Produkthandbuch" }
);
console.log("Updated:", result.result.name);
```

## Antwortformat

### Erfolgreiche Antwort (200 OK)

```typescript theme={null}
{
  status: "success";
  result: {
    id: string;
    name: string;
    description: string | null;
    createdAt: string;
    updatedAt: string;
  };
}
```

### Beispielantwort

```json theme={null}
{
  "status": "success",
  "result": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Produkthandbuch",
    "description": "Interne Produktdokumentation",
    "createdAt": "2026-08-12T09:15:00.000Z",
    "updatedAt": "2026-09-01T10:22:00.000Z"
  }
}
```

## Fehlerbehandlung

| Status | Bedeutung                                                                                              |
| ------ | ------------------------------------------------------------------------------------------------------ |
| `400`  | Ungültiger Body, leerer Name oder kein Feld gesetzt                                                    |
| `401`  | Ungültiger oder fehlender API-Schlüssel                                                                |
| `403`  | Fehlender `KNOWLEDGE_FOLDER_API` Scope, oder der Schlüssel ist kein Bearbeiter dieser Wissensdatenbank |
| `404`  | Wissensdatenbank nicht gefunden                                                                        |
| `429`  | Rate Limit überschritten                                                                               |
| `500`  | Unerwarteter Serverfehler                                                                              |

<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 patch /knowledge/{folderId}/folder
openapi: 3.0.0
info:
  title: Langdock API
  version: 3.0.0
servers:
  - url: https://api.langdock.com
    description: Production
security:
  - bearerAuth: []
paths:
  /knowledge/{folderId}/folder:
    patch:
      summary: Update a Knowledge base name or description
      parameters:
        - name: folderId
          in: path
          required: true
          description: The ID of the knowledge folder
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
      responses:
        '200':
          description: Knowledge base updated successfully
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````