Start an asynchronous bulk import from an S3 bucket. Returns job_id; poll lookup until COMPLETED or FAILED.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Start an asynchronous bulk import of media objects from an Amazon S3 bucket you control. The API returns a job_id; poll Lookup bulk upload until status is COMPLETED or FAILED.
POST /v2/bulk-uploads
Authenticate withX-Api-Keyand sendX-Format: default. JSON bodies needContent-Type: application/json. A successful create returns 200 with{ "job_id": "…" }.
IAM credentials must allow s3:ListBucket on the bucket and s3:GetObject on the objects to import. Pass the bucket region (for example eu-north-1).
Only upload_type: s3 is accepted. Object keys currently processed are those ending in .mp4 or .mp3. Other extensions in the same bucket are skipped.
unique_upload_name must be unique on the account. Reusing a name returns 400.
While a job is running, lookup may keep showing STARTED with nb_success / nb_failed still "0" until the job finishes - poll until a terminal status. Successful objects become VOD assets (listed under List videos; the VOD title typically matches the S3 object key).
| Field | Required | Notes |
|---|---|---|
unique_upload_name | yes | Unique label for this job. |
upload_type | yes | Must be s3. |
bucket_name | yes | S3 bucket name. |
region | yes | AWS region of the bucket. |
iam_access_key | yes | IAM access key id. |
iam_secret_token | yes | IAM secret access key. |
See also Lookup bulk upload and List bulk uploads.