> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dokument aktualisieren

> Aktualisiert den Namen oder die Beschreibung eines Dokuments

Dieser Endpunkt aktualisiert die Metadaten eines bestehenden Dokuments. Du kannst nur den Namen und die Beschreibung aktualisieren - der Dokumenttyp und der Inhalt können nicht geändert werden.

### Pfad-Parameter

<ParamField path="knowledgebaseId" type="integer" required>
  Die eindeutige Kennung der Wissensdatenbank
</ParamField>

<ParamField path="documentId" type="integer" required>
  Die eindeutige Kennung des zu aktualisierenden Dokuments
</ParamField>

### Request Body

<ParamField body="name" type="string">
  Der neue Name für das Dokument (max. 255 Zeichen)
</ParamField>

<ParamField body="description" type="string">
  Die neue Beschreibung für das Dokument (max. 255 Zeichen)
</ParamField>

### Antwort-Felder

<ResponseField name="message" type="string">
  Erfolgsmeldung
</ResponseField>

<ResponseField name="data" type="object">
  Das aktualisierte Dokument-Objekt

  <Expandable title="Daten-Eigenschaften">
    <ResponseField name="id" type="integer">
      Die eindeutige Kennung des Dokuments
    </ResponseField>

    <ResponseField name="name" type="string">
      Der Name des Dokuments
    </ResponseField>

    <ResponseField name="description" type="string">
      Beschreibung des Dokuments
    </ResponseField>

    <ResponseField name="type" type="string">
      Dokumenttyp
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Menschenlesbares Typ-Label
    </ResponseField>

    <ResponseField name="status" type="string">
      Verarbeitungsstatus
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Menschenlesbares Status-Label
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 Zeitstempel der letzten Aktualisierung
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Um den Inhalt eines Dokuments zu aktualisieren, musst du das bestehende Dokument löschen und ein neues mit dem aktualisierten Inhalt erstellen.
</Note>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "Document updated successfully.",
    "data": {
      "id": 1,
      "name": "Aktualisiertes Produkthandbuch",
      "description": "Überarbeitetes Benutzerhandbuch mit neuen Funktionen",
      "type": "pdf",
      "type_label": "PDF",
      "status": "active",
      "status_label": "Aktiv",
      "updated_at": "2025-01-08T15:45:00.000000Z"
    }
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Knowledgebase not found."
  }
  ```

  ```json 404 Document Not Found theme={null}
  {
    "error": "Document not found."
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The name may not be greater than 255 characters.",
    "errors": {
      "name": [
        "The name may not be greater than 255 characters."
      ]
    }
  }
  ```
</ResponseExample>

<Tip>
  Passende Seiten: [Introduction](/de/api-reference/introduction) und [Authentication Guide](/de/developers/authentication-guide) und [API Integration Examples](/de/developers/api-integration-examples).
</Tip>
