Skip to main content
POST
Start an upload

Authorizations

Authorization
string
header
required

Project API key. Server-side only.

Headers

Idempotency-Key
string

Any unique string. A retry with the same key within 24 hours returns the first result.

Maximum string length: 255

Path Parameters

projectId
string
required
Pattern: ^prj_[A-Za-z0-9]+$

Body

application/json
title
string
required
Required string length: 1 - 200
Example:

"Lesson 1 - Introduction"

fileName
string
required
Maximum string length: 255
Example:

"lesson-01.mp4"

sizeBytes
integer
required

File size. The plan sets the maximum.

Required range: x >= 1
Example:

2147483648

contentType
enum<string>
required
Available options:
video/mp4,
video/quicktime,
video/webm,
video/x-matroska

Response

Upload started.

id
string
required
Example:

"upl_2bN6rD"

video
object
required
partSizeBytes
integer
required

Size of every part except the last one.

Example:

104857600

parts
object[]
required
expiresAt
string<date-time>
required