Upload large file through streaming

POST /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

FILE_UPLOAD

Query Parameters

ParameterDefaultDescription
filenamerequired Specifies the file name after upload.
folder/optional Specifies the directory (folder) where to upload the file to.

Example

Request

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

Response

{
  "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"
  }
}