Upload (Stream) File with PUT

PUT /upload

The PUT method is useful for uploading files bigger 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 (POST).

API Permissions

FILE_UPLOAD

Query Parameters

ParameterDefaultDescription
filename[Required]Specifies the file name after upload.
dir/ [Optional]Specifies the directory (folder) where to upload the file to.

Example

Request

This demo does not support the API Explorer.

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

Response

Success

{
    "status": "success",
    "file": {
        "uuid": "faf3ace8-0ba2-57bc-a553-80b7e6050000",
        "name": "boat.jpg",
        "type": "image/jpeg",
        "size": 551378,
        "sha1": "b3583bf93ef8ef8cd6687056a2d723c90f2e1b08",
        "meta": {},
        "url_permalink": "https://store.api.airstore.io/v1/get/_/faf3ace8-0ba2-57bc-a553-80b7e6050000/boat.jpg",
        "url_public": "https://fusqadtm.airstore.io/boat.jpg",
        "properties": {},
        "overwrite": false
    },
    "info": {
        "uniq_id": "4b49084e6c9d4b9e9d5461a5d9b9d9ac",
        "uploaded_files": 1,
        "version": "09f7cd0",
        "project_uuid": "094dd930-ccd3-4945-a051-a55b484678a8",
        "files_count": 1,
        "init_db": "atom008:15",
        "input_info": [],
        "company_uuid": "c543bc43-0000-1111-2222-b5293daf15f4",
        "trace": "DJTeu-ov-624.elastic-uploader.airstore.scal3fl3x.com5v"
    }
}

Errors

{
    "status": "error",
    "code": "ERR_UNPROCESSABLE_ENTITY",
    "msg": "Sorry, we could not process the upload because the input does not look correct! Please check the parsing and try again",
    "hint": "Please check the docs: http://docs.filerobot.com/"
}
{
    "status": "error",
    "code": "ERR_UNAUTHORIZED",
    "msg": "Invalid secret key",
    "hint": "Provide valid secret key."
}