بارگذاری یک فایل
یک سند یا تصویر که به‌عنوان بدنهٔ درخواست فرستاده و در پس‌زمینه خوانده می‌شود.
فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.
POST /knowledge/files
یک سند یا تصویر که به‌عنوان بدنهٔ درخواست فرستاده و در پس‌زمینه خوانده می‌شود.
نمونه
به knowledge:write نیاز دارد. خود فایل را با Content-Type آن به‌عنوان بدنه بفرستید و با filename یا سرآیند X-Filename نامش را بدهید. scope و title هم در کوئری می‌آیند. سند می‌تواند تا 20 MB و تصویر تا 10 MB باشد. با فایل، در وضعیت queued، 201 برمی‌گرداند.
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}وقتی Content-Type عمومی باشد، پسوند نام نوع فایل را تعیین می‌کند. نوع فایلی که نمی‌شود خواند یک 422 knowledge_file_unsupported است، فایل خالی یک 422 knowledge_file_empty، و فایلی بیش از حد یک 413 knowledge_file_too_large.
فایلی که متنی ندارد با failure: "empty" در وضعیت failed تمام می‌شود. فرستادن یک فایل برای دو بار، آن را دو بار ذخیره می‌کند.