Create new upload

Initiates a new upload using the TUS protocol. This endpoint creates an upload session and returns the URL where file chunks should be sent.

Required Metadata:
All metadata fields must be base64 encoded and sent in the Upload-Metadata header.

  • authorization: Authentication token
  • bucket_id: UUID of the bucket where the file will be stored
  • filename: File name
  • filetype: MIME type of the file

Optional Metadata:

  • folder_id: UUID of the folder where the file will be stored
  • type: File category (video, audio, image, document, archive, other)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
integer
required
≥ 1

Total file size in bytes

string
required

Base64 encoded metadata in the format: key1 base64value1,key2 base64value2

Example: filename dGVzdC5wZGY=,filetype YXBwbGljYXRpb24vcGRm,bucket_id YnVja2V0LXV1aWQ=,authorization QmVhcmVyIHRva2Vu

string
enum
required
Defaults to 1.0.0

TUS protocol version

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json