Importer un fichier
Un document ou une image, envoyé comme corps de la requête et lu en arrière-plan.
Exécute le véritable appel sur votre espace de travail.
POST /knowledge/files
Un document ou une image, envoyé comme corps de la requête et lu en arrière-plan.
Exemple
Nécessite knowledge:write. Envoyez le fichier lui-même comme corps avec son Content-Type, et nommez-le avec filename ou un en-tête X-Filename. scope et title vont aussi dans la requête. Un document peut faire jusqu'à 20 Mo et une image jusqu'à 10 Mo. Répond 201 avec le fichier, 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}L'extension du nom donne le type de fichier quand le Content-Type est générique. Un type de fichier qui ne peut pas être lu est une 422 knowledge_file_unsupported, un fichier vide une 422 knowledge_file_empty, et un fichier au-delà de la limite une 413 knowledge_file_too_large.
Un fichier sans texte finit en failed avec failure: "empty". Envoyer deux fois le même fichier le stocke deux fois.