Upload large file through streaming

PUT /v4/files

This method is useful for uploading files larger than 500MB. The content of the request will be streamed into to the storage container. If you are uploading smaller files, use the standard Upload API.

API Permissions


Query Parameters

Parameter Default Description
filename required Specifies the file name after upload.
folder / optional Specifies the directory (folder) where to upload the file to.



This demo does not support the API Explorer.

curl --request POST \
  --url 'https://api.filerobot.com/v4/files?folder=/myfolder&filename=test.jpg' \
  --header 'content-type: application/octet-stream' \
  --header 'X-Filerobot-Key:  ebba5ece8757438cb3acf9a9ef7ba07a' \
  -T /path/to/file


  "status": "success",
  "file": {
    "uuid": "b4eab81c-84b7-543d-b2f3-364ce7750001",
    "name": "test",
    "size": {
      "bytes": 451381,
      "pretty": "440.8 KB"
    "type": "application/octet-stream",
    "url": {
      "public": "https://store.filerobot.com/fdocs/api-demo/test",
      "permalink": "https://api.filerobot.com/fdocs/v4/get/b4eab81c-84b7-543d-b2f3-364ce7750001",
      "cdn": "https://fdocs.filerobot.com/api-demo/test.please.delete?vh=f87f1c&func=proxy",
      "path": "/api-demo/test"
    "hash": {
      "sha1": "f87f1c2e708b1111aa8aa99640efec02aaeb130b",
      "blur_hash": null
    "created_at": "2021-05-10T11:36:28Z",
    "modified_at": "2021-05-10T11:36:28Z",
    "overwrite": false,
    "folder": {
      "uuid": "7610923e-80d0-50e8-a2e4-c509be390158",
      "name": "/api-demo"
    "info": {},
    "meta": {}
  "info": {
    "version": 2.19,
    "trace": "sw0ZBs8DJ-eu-ms-xxxtest.elastic-uploader.airstore.scal3fl3x.com",
    "uniq_id": "1b869e2271da4d8d8aee17ae45c80a2a",
    "project_uuid": "094dd930-ccd3-4945-a051-a55b484678a8",
    "company_uuid": "c543bc43-0000-1111-2222-b5293daf15f4",
    "uploaded_files": 1,
    "files_count": 1,
    "input_info": "",
    "init_db": "atom008:84"