Skip to main content
POST
Start a presigned video upload

Authorizations

Authorization
string
header
required

Pass your pk_live_... API key as a Bearer token.

Path Parameters

connector_id
string
required

Body

application/json
filename
string
required

Original filename; must end in .mp4 or .mov.

Example:

"drone-show.mp4"

size_bytes
integer
required

Exact size of the file in bytes. Verified server-side on complete.

content_type
string | null

video/mp4 or video/quicktime. Inferred from the filename extension if omitted.

Response

Successful Response

file_id
string
required

external_id the resulting event will carry; pass back on complete.

upload_id
string
required

S3 multipart upload id; pass back on complete.

key
string
required

S3 key the video will land at.

part_size_bytes
integer
required

Upload the file in consecutive chunks of this size (last part may be smaller).

part_urls
string[]
required

Presigned PUT URLs, one per part, in part order. Collect each response's ETag.

expires_in_seconds
integer
required

Validity window of the presigned URLs.