Create Video

Start an ajax or curl VOD upload. Returns storage credentials, not a playable video.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Start an ajax or curl VOD upload. This call returns storage credentials, not a playable video. Encoding is asynchronous: the file is not ready when this HTTP call returns 200.

Step-by-step for all three upload methods (including multipart): VOD Upload.

📘

Use the bucket or signed URL from this response. Do not hardcode an upload host. Generate a fresh signature for every file.

ajax: POST the file as a form to https://{bucket}. Send every signature field, then file last. The last segment of key is not the final VOD id.

curl: PUT the file using curl-command (or url). The id in this response is not reliably the final VOD id.

After the file lands, find the asset with List videos (filter by the source filename — list title matches source) and poll Lookup video until online is true. Set a display name later with Update video.

For files larger than 5 GB, use multipart instead: Initiate, Get presigned URLs, Complete.

Body Params
string
required

Filename being uploaded.

string
enum
required

ajax for a browser form POST, or curl for a signed PUT. Multipart is a separate flow.

Allowed:
boolean

Start encoding after the file lands in storage.

string

Optional. If set, Dacast POSTs file_id and title here when processing finishes. Not required; you can poll List/Lookup instead.

string

Optional. ID of another video; this upload becomes a rendition of that parent.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json