POST
Start an upload

Authorizations

Authorization
string
header
required

A token from POST /token/create, made with your API key pair.

Path Parameters

id
string
required

The project id, a lowercase ULID.

Pattern: ^[0-9a-z]{26}$

Body

application/json
name
string
required

The file’s name under input/; season 2/episode 01.mp4 puts it in a subfolder. It needs a media extension, and must not contain ${.

size
integer
required

Its size in bytes; it decides partSize and partCount.

Required range: 1 <= x <= 5497558138880
type
string

Its media type, stored with the file by a parts upload. A one-PUT upload stores the Content-Type header the PUT sends, if any.

overwrite
boolean
default:false

Replace a file of the same name. The new file is processed, and billed, again. Replace a failed file under a new name instead: its old content would be processed again.

Response

Started

data
object
required