Skip to main content
POST
Upload a video in one request

Authorizations

Authorization
string
header
required

A scoped token minted in Settings → API tokens. Send it as Authorization: Bearer tplt_… or X-API-Key: tplt_….

Headers

Idempotency-Key
string

Retry-safe key. The first response for a given key is cached for 24 hours and replayed on a repeat, with Idempotency-Replayed: true set.

Path Parameters

video
integer
required

The video's numeric ID.

Body

multipart/form-data
file
file
required

The video file. Up to 3,000 MB in one request (use the resumable protocol for up to 5 GB). mp4, mov, m4v, avi, webm, ogv, 3gp or mkv.

orientation
enum<string>
default:landscape
Available options:
landscape,
portrait

Response

Accepted. The file is stored and on its way to the encoder. Poll GET /videos/{video}/status until status is ready.

video
object

The processing status of a video. Returned by every upload call and by GET /videos/{video}/status.