फ़ाइल अपलोड करें
वर्कस्पेस में एक फ़ाइल रखता है, जैसे फ़ाइलें पेज पर अपलोड करें बटन करता है। बॉडी ख़ुद फ़ाइल है, न JSON और न multipart, और उसका प्रकार `Content-Type` में होता है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /files
वर्कस्पेस में एक फ़ाइल रखता है, जैसे फ़ाइलें पेज पर अपलोड करें बटन करता है। बॉडी ख़ुद फ़ाइल है, न JSON और न multipart, और उसका प्रकार Content-Type में होता है।
उदाहरण
threads:write चाहिए। फ़ाइल का नाम filename क्वेरी पैरामीटर से दें, या URI-एन्कोड किए X-Filename हेडर से। जवाब फ़ाइल के साथ एक 201 होता है, और उसका id किसी भेजने में { 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 मिलता है।