Skip to main content

Start Product Video Upload

POST 

/api/products/:product/videos/uploads

Start a multipart upload of a video attached to the product. Returns the new video (status uploading), the part size (16 MB) and one upload URL per part.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Upload flow: 1) start an upload to get one URL per part; 2) PUT each part's bytes (part n = bytes (n-1)part_size up to npart_size; the last part holds the remainder) to its URL with no Authorization header — parts can be sent in parallel and retried individually; 3) call Complete; 4) poll until status is ready or failed. Part URLs are valid for 12 hours (refresh them with Get Upload URLs). Uploads not completed within 24 hours are marked failed and their parts discarded.

Body: filename (required, .mp4/.mov/.webm/.m4v), size in bytes (required, at most 1 GB = 1073741824), mime (required: video/mp4, video/quicktime or video/webm).

Authentication: Requires Bearer token (scope products:write).

Request​

Responses​

Created

Response Headers
    Content-Type