Ngarko një skedar
Ruan një skedar në hapësirën e punës, ashtu si butoni Ngarko në faqen Skedarët. Trupi është vetë skedari, jo JSON dhe jo multipart, me llojin e tij në `Content-Type`.
Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.
POST /files
Ruan një skedar në hapësirën e punës, ashtu si butoni Ngarko në faqen Skedarët. Trupi është vetë skedari, jo JSON dhe jo multipart, me llojin e tij në Content-Type.
Shembull
Kërkon threads:write. Emërtojeni skedarin me parametrin e kërkesës filename, ose me një header X-Filename të koduar si URI. Përgjigjja është një 201 me skedarin, dhe ID-ja e tij mund t'i bashkëngjitet një dërgimi si { 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"}Një emër pastrohet në vend që të refuzohet: shenjat që një emër skedari nuk mund t'i mbajë bëhen _, dhe një emër më i gjatë se 255 shenja shkurtohet duke ruajtur prapashtesën. Një Content-Type që nuk është lloj MIME ruhet si application/octet-stream.
Mungesa e emrit është një 400 upload_no_name, një program ose skript një 400 upload_dangerous, një trup bosh një 400 upload_empty, dhe një skedar mbi 100 MB një 413 upload_too_large.
Një hapësirë pune pranon 500 ngarkime në orë, duke përfshirë ato të fshira, dhe mban 10 GB skedarë të ngarkuar njëherësh. Përtej tyre përgjigjja është një 429 upload_rate_limited ose një 507 upload_storage_full. Një 502 upload_failed do të thotë se ruajtja dështoi dhe ia vlen të provohet sërish.
Një çelës që arrin çdo adresë ngarkon në të gjithë hapësirën e punës, me deliveredTo null. Një çelës i kufizuar në adresa ose domene të caktuara ngarkon te adresa e parë që mban, dhe një që nuk mban asnjë merr një 403 upload_no_address.