Dosya yükle
Dosyalar sayfasındaki Yükle düğmesinin yaptığı gibi çalışma alanına bir dosya kaydeder. Gövde dosyanın kendisidir; JSON ya da multipart değildir ve türü `Content-Type` içindedir.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
POST /files
Dosyalar sayfasındaki Yükle düğmesinin yaptığı gibi çalışma alanına bir dosya kaydeder. Gövde dosyanın kendisidir; JSON ya da multipart değildir ve türü Content-Type içindedir.
Örnek
threads:write gerekir. Dosyaya filename sorgu parametresiyle ya da URI olarak kodlanmış bir X-Filename başlığıyla ad verin. Yanıt, dosyayla birlikte bir 201 olur ve kimliği bir gönderime { fileId } olarak eklenebilir.
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"}Bir ad reddedilmek yerine temizlenir: bir dosya adında bulunamayacak karakterler _ olur ve 255 karakterden uzun bir ad, uzantısı korunarak kısaltılır. MIME türü olmayan bir Content-Type, application/octet-stream olarak kaydedilir.
Ad yoksa 400 upload_no_name, bir program ya da betik için 400 upload_dangerous, boş bir gövde için 400 upload_empty, 100 MB’ı aşan bir dosya için 413 upload_too_large döner.
Bir çalışma alanı, silinenler dahil saatte 500 yükleme kabul eder ve aynı anda 10 GB yüklenmiş dosya tutar. Bunların ötesinde yanıt 429 upload_rate_limited ya da 507 upload_storage_full olur. 502 upload_failed depolamanın başarısız olduğu anlamına gelir ve yeniden denemeye değer.
Her adrese erişen bir anahtar tüm çalışma alanına yükler ve deliveredTo null olur. Belirli adreslerle ya da alan adlarıyla sınırlı bir anahtar tuttuğu ilk adrese yükler; hiç adresi olmayan bir anahtar 403 upload_no_address alır.