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

# Attachment in einer Wissensdatenbank aktualisieren

> Ersetze eine bestehende Datei in einer Wissensdatenbank durch eine neue Version

Aktualisiert eine bestehende Datei (Attachment) in einer Wissensdatenbank, indem sie durch eine neue Version ersetzt wird. Die alte Datei wird entfernt und die neue Datei wird verarbeitet und eingebettet.

## Bevor du startest

* **API-Key-Scope**: Erfordert einen API-Schlüssel mit dem `KNOWLEDGE_FOLDER_API` Scope. Der API-Schlüssel selbst benötigt die Rolle Bearbeiter für die Wissensdatenbank. Siehe [Wissensdatenbank mit der API teilen](https://docs.langdock.com/de/developer/knowledge-folder-api/sharing.md) für die Einrichtung.

## Basis-URL

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

> [!WARNING]
>
> **Dedicated Deployments**
>
> Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.

## Anforderungsformat

Dieser Endpunkt akzeptiert `multipart/form-data` Anfragen mit der angehängten Datei.

### Pfadparameter

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

### Formularfelder

| Feld | Typ | Erforderlich | Beschreibung |
| - | - | - | - |
| `attachmentId` | string | Ja | Die ID des zu aktualisierenden Attachments |
| `file` | file | Ja | Die neue Datei zum Hochladen. Siehe die Größenlimits unten. |
| `url` | string | Nein | URL, die Nutzern angezeigt wird, wenn diese Datei in einer Antwort verwendet wird |

Die Größenlimits hängen vom Dateityp ab: 10 MB für reinen Text, Markdown, JSON und VTT-Dateien, 30 MB für XML-Dateien und 256 MB für andere unterstützte Dokumenttypen. Eine Übersicht der unterstützten Formate findest du in der [Referenz unterstützter Dateitypen](https://docs.langdock.com/de/using-langdock/troubleshooting/faq/supported-file-types.md).

## Beispiele

### Aktualisieren mit cURL

```bash theme={null}
curl -X PATCH "https://api.langdock.com/knowledge/{folderId}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "attachmentId=att_abc123def456" \
  -F "file=@/pfad/zu/neues-dokument.pdf"
```

### Aktualisieren mit JavaScript

```javascript theme={null}
const FormData = require("form-data");
const fs = require("fs");
const axios = require("axios");

async function updateAttachment(folderId, attachmentId, filePath) {
  const form = new FormData();
  form.append("attachmentId", attachmentId);
  form.append("file", fs.createReadStream(filePath));

  const response = await axios.patch(
    `https://api.langdock.com/knowledge/${folderId}`,
    form,
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        ...form.getHeaders(),
      },
    }
  );

  return response.data;
}

// Beispiel
try {
  const result = await updateAttachment(
    "folder_abc123",
    "att_xyz789",
    "/pfad/zu/aktualisierter-bericht.pdf"
  );
  console.log("Attachment aktualisiert:", result);
} catch (error) {
  console.error("Aktualisierung fehlgeschlagen:", error.response?.data?.message);
}
```

### Aktualisieren mit Quell-URL

```javascript theme={null}
const FormData = require("form-data");
const fs = require("fs");
const axios = require("axios");

async function updateAttachmentWithUrl(folderId, attachmentId, filePath, sourceUrl) {
  const form = new FormData();
  form.append("attachmentId", attachmentId);
  form.append("file", fs.createReadStream(filePath));
  form.append("url", sourceUrl);

  const response = await axios.patch(
    `https://api.langdock.com/knowledge/${folderId}`,
    form,
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        ...form.getHeaders(),
      },
    }
  );

  return response.data;
}
```

## Antwortformat

### Erfolgreiche Antwort (200 OK)

```typescript theme={null}
{
  status: "success";
  result: {
    id: string;          // Eindeutige Attachment-ID
    name: string;        // Originaler Dateiname
    mimeType: string;    // MIME-Typ der Datei
    createdAt: string;   // ISO 8601 Zeitstempel
    updatedAt: string;   // ISO 8601 Zeitstempel
    url: string | null;  // Quell-URL, falls angegeben
  };
}
```

### Beispielantwort

```json theme={null}
{
  "status": "success",
  "result": {
    "id": "att_abc123def456",
    "name": "aktualisierter-bericht.pdf",
    "mimeType": "application/pdf",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-20T14:45:00.000Z",
    "url": null
  }
}
```

### Antwort bei fehlgeschlagener Dateivalidierung (400 Bad Request)

Wenn die Validierung der Ersatzdatei fehlschlägt, findest du den Grund in `message`:

```json theme={null}
{
  "message": "The file \"aktualisierter-bericht.pdf\" is declared as a PDF but its content does not start with the expected PDF header.",
  "code": "BAD_REQUEST"
}
```

## Fehlerbehandlung

```javascript theme={null}
try {
  const response = await updateAttachment(folderId, attachmentId, filePath);
} catch (error) {
  if (error.response) {
    console.error(error.response.data.message ?? "Aktualisierung fehlgeschlagen");
  }
}
```

| Status | Bedeutung |
| - | - |
| `400` | Ungültige Anfrage oder Fehler bei der Dateivalidierung |
| `401` | Ungültiger oder fehlender API-Schlüssel |
| `403` | API-Schlüssel hat keinen Zugriff auf die Wissensdatenbank |
| `404` | Wissensdatenbank oder Attachment nicht gefunden |
| `408` | Zeitüberschreitung beim Upload |
| `413` | Datei überschreitet das Größenlimit |
| `429` | Rate Limit überschritten |
| `500` | Unerwarteter Server-Fehler |
| `503` | Speicherkapazität überschritten |

## Verarbeitungsstatus

Nach der Aktualisierung wird die neue Datei asynchron verarbeitet. Verwende den [Dateien abrufen](https://docs.langdock.com/de/developer/knowledge-folder-api/retrieve-files.md) Endpunkt, um den Verarbeitungsstatus zu prüfen. Das `syncStatus` Feld zeigt den aktuellen Zustand:

* `UPLOADING` - Datei wird hochgeladen
* `UPLOADED` - Datei hochgeladen und in der Warteschlange
* `EXTRACTING` - Text wird aus der Datei extrahiert
* `EMBEDDING` - Embeddings werden generiert
* `SYNCED` - Datei ist bereit für die Suche
* `ACTION_FAILED`, `EXTRACTION_FAILED`, `EMBEDDING_FAILED`, `TIMEOUT` - Verarbeitung fehlgeschlagen

> [!NOTE]
>
> 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](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.