Eine Datei hochladen
Ein Dokument oder ein Bild, als Anfragetext gesendet und im Hintergrund gelesen.
Führt den echten Aufruf in Ihrem Workspace aus.
POST /knowledge/files
Ein Dokument oder ein Bild, als Anfragetext gesendet und im Hintergrund gelesen.
Beispiel
Erfordert knowledge:write. Senden Sie die Datei selbst als Text der Anfrage mit ihrem Content-Type und benennen Sie sie mit filename oder einem X-Filename-Header. scope und title gehen ebenfalls in die Query. Ein Dokument darf bis zu 20 MB groß sein und ein Bild bis zu 10 MB. Antwortet 201 mit der Datei, queued.
curl -X POST "$OE/knowledge/files?filename=price-list.pdf&[email protected]" -H "$AUTH" \ -H "Content-Type: application/pdf" --data-binary @price-list.pdf{ "object": "knowledge_item", "id": "kb_9a4d2c7e1b5f3086d2e4a19c", "kind": "file", "scope": "[email protected]", "level": "address", "title": "price-list", "url": null, "fileName": "price-list.pdf", "mimeType": "application/pdf", "sizeBytes": 482113, "pinned": false, "status": "queued", "failure": null, "chunks": 0, "chars": 0, "origin": "api", "createdBy": "usr_5f2a9c71", "createdAt": "2026-10-08T09:15:30.000Z", "updatedAt": "2026-10-08T09:15:30.000Z", "indexedAt": null}Die Endung des Namens bestimmt die Art der Datei, wenn der Content-Type allgemein ist. Eine Art von Datei, die nicht gelesen werden kann, ist ein 422 knowledge_file_unsupported, eine leere ein 422 knowledge_file_empty und eine über dem Limit ein 413 knowledge_file_too_large.
Eine Datei ohne Text darin endet als failed mit failure: "empty". Dieselbe Datei zweimal zu senden speichert sie zweimal.