post
https://developer.dacast.com/v2/vod/upload/init-multipart
Initiate a multi-part VOD upload
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Start a multipart VOD upload session. Use this flow for large files (required above 5 GB). Full walkthrough: VOD Upload - Multipart.
Next steps: Get presigned URLs, then Complete Multipart.
Authenticate withX-Api-Keyand sendX-Format: default. JSON bodies needContent-Type: application/json. Host:https://developer.dacast.com.
Storage is chosen server-side (today often Wasabi; AWS may appear later). Always use the s3_path and later the presigned_urls you receive - do not hardcode upload.dacast.com.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
filename | string | Yes | Name of the file being uploaded (for example yourFileNameHere.mp4). |
destination_folders_ids | array of string | No | Numeric folder ids to place the VOD into after upload (for example ["1259852"]). See List Folders / Folders. |
recipe_id | string | No | Non-default encoding recipe id from Lookup Recipes (recipeId). Omit to use the account default. |
Example
curl -X POST "https://developer.dacast.com/v2/vod/upload/init-multipart" \
-H "X-Api-Key: insertYourApiKeyHere" \
-H "X-Format: default" \
-H "Content-Type: application/json" \
-d "{\"filename\":\"yourFileNameHere.mp4\"}"Response (200)
{
"s3_path": "s3://universe-vod-storage-us-east-2/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/ffffffff-1111-2222-3333-444444444444/source.mp4",
"uploader_id": "Akh-…"
}| Field | Description |
|---|---|
s3_path | Storage path for this upload. Pass the same value to signatures and complete. |
uploader_id | Upload session id. Pass the same value to signatures and complete. |
A successful call returns 200. Keep both fields for the rest of the flow.