بارگذاری یک فایل
فایلی را در فضای کاری ذخیره میکند، همانطور که دکمهٔ بارگذاری در صفحهٔ فایلها میکند. بدنه خودِ فایل است، نه JSON و نه multipart، و نوعش در `Content-Type` میآید.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
POST /files
فایلی را در فضای کاری ذخیره میکند، همانطور که دکمهٔ بارگذاری در صفحهٔ فایلها میکند. بدنه خودِ فایل است، نه JSON و نه multipart، و نوعش در Content-Type میآید.
نمونه
به threads:write نیاز دارد. نام فایل را با پارامتر پرسوجوی filename بدهید، یا با سرآیند X-Filename که با URI رمزگذاری شده. پاسخ یک 201 همراه فایل است، و شناسهاش را میشود به شکل { fileId } به یک ارسال پیوست کرد.
curl -X POST "$OE/files?filename=price-list.pdf" -H "$AUTH" -H 'content-type: application/pdf' --data-binary @price-list.pdf{ "object": "file", "id": "file_0c4e7a91d2b84f63a5e19b7d", "filename": "price-list.pdf", "mimeType": "application/pdf", "sizeBytes": 248112, "direction": "uploaded", "threadId": null, "messageId": null, "deliveredTo": null, "usage": null, "deletable": true, "createdAt": "2026-09-24T09:12:40.000Z"}نام به جای رد شدن پاکسازی میشود: نویسههایی که نام فایل نمیتواند داشته باشد به _ تبدیل میشوند، و نامی بلندتر از 255 نویسه با نگه داشتن پسوندش کوتاه میشود. Content-Typeی که نوع MIME نیست به شکل application/octet-stream ذخیره میشود.
نبودِ نام یک 400 upload_no_name است، یک برنامه یا اسکریپت 400 upload_dangerous، بدنهٔ خالی 400 upload_empty، و فایل بزرگتر از 100 MB یک 413 upload_too_large.
هر فضای کاری در ساعت 500 بارگذاری میپذیرد، حذفشدهها هم حساب میشوند، و در هر لحظه 10 GB فایل بارگذاریشده نگه میدارد. فراتر از اینها پاسخ یک 429 upload_rate_limited یا یک 507 upload_storage_full است. 502 upload_failed یعنی ذخیرهسازی شکست خورد و ارزش دوباره امتحان کردن دارد.
کلیدی که به همهٔ نشانیها میرسد در کل فضای کاری بارگذاری میکند، با deliveredTo برابر null. کلیدی که به نشانیها یا دامنههای خاصی محدود است در نخستین نشانیای که دارد بارگذاری میکند، و کلیدی که هیچ نشانی ندارد یک 403 upload_no_address میگیرد.