Control Panel — API documentation

File Upload

File Upload

Files can be uploaded to the file storage using a POST. The file will take on the filepath and name used in the URI to make the call. Any directories that do not already exist will be created. Once a file has been uploaded it can be managed using the Files endpoint. Curl requests require an '@' before the filename for the file to be sent.


name String Autogenerated


Sample value:my-vod.mp4

path String Autogenerated

File path with filename

Sample value:/recordings/my-vod.mp4

parent String Autogenerated

parent folder

Sample value:/recordings

type String Autogenerated

file type

Enum:file, symlink, directory

Sample value:file

size Integer Autogenerated

file size in bytes

Sample value:3552999

filename[] Object Normal Required

File to be uploaded.

Sample value:



You cannot read from this endpoint.

Update the Upload object with path recordings/my-vod.mp4.

Example URL

Example cURL

curl --form 'filename[]=@myvodfile.mp4' --user 158:8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f

Example request body


Example response data

    "name": "my-vod.mp4",
    "path": "/recordings/my-vod.mp4",
    "parent": "/recordings",
    "type": "file",
    "size": "3552999"

You cannot rename a file from this endpoint.

You cannot delete a file from this endpoint.



You do not have access to modify this field