Belgelere geç
API

Dosya yükle

İstek gövdesi olarak gönderilip arka planda okunan bir belge ya da görsel.

POST/knowledge/files

Gerçek çağrıyı çalışma alanınızda çalıştırır.

POST /knowledge/files

İstek gövdesi olarak gönderilip arka planda okunan bir belge ya da görsel.

Örnek

knowledge:write gerektirir. Dosyanın kendisini Content-Type değeriyle gövde olarak gönderin ve onu filename ya da bir X-Filename başlığıyla adlandırın. scope ve title da sorguya girer. Bir belge en fazla 20 MB, bir görsel en fazla 10 MB olabilir. Dosyayla birlikte queued durumunda 201 döner.

curl
curl -X POST "$OE/knowledge/files?filename=price-list.pdf&[email protected]" -H "$AUTH" \  -H "Content-Type: application/pdf" --data-binary @price-list.pdf
Yanıt
{  "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}

Content-Type genel olduğunda dosyanın türünü adının uzantısı belirler. Okunamayan bir dosya türü 422 knowledge_file_unsupported, boş bir dosya 422 knowledge_file_empty, sınırı aşan bir dosya ise 413 knowledge_file_too_large olur.

İçinde metin olmayan bir dosya failure: "empty" ile failed olarak biter. Aynı dosyayı iki kez göndermek onu iki kez saklar.

Referans