Carregar um ficheiro
Um documento ou uma imagem, enviado como corpo do pedido e lido em segundo plano.
Executa a chamada real no seu espaço de trabalho.
POST /knowledge/files
Um documento ou uma imagem, enviado como corpo do pedido e lido em segundo plano.
Exemplo
Requer knowledge:write. Envie o próprio ficheiro como corpo com o seu Content-Type, e dê-lhe nome com filename ou um cabeçalho X-Filename. scope e title também vão na consulta. Um documento pode ter até 20 MB e uma imagem até 10 MB. Responde 201 com o ficheiro, 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}A extensão do nome indica o tipo de ficheiro quando o Content-Type é genérico. Um tipo de ficheiro que não pode ser lido é um 422 knowledge_file_unsupported, um vazio um 422 knowledge_file_empty, e um acima do limite um 413 knowledge_file_too_large.
Um ficheiro sem texto termina em failed com failure: "empty". Enviar o mesmo ficheiro duas vezes guarda-o duas vezes.