v5

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-0112516159.5 KB

Upload media to collection

post/collection/{collection_id}/upload

Path parameters

collection_idstring required
Example:default

Request body

urlstring required
namestring
media_type'video' | 'audio' | 'image'
callback_urlstring

Example request

{
  "url": "https://example.com/video.mp4",
  "name": "My Video",
  "media_type": "video",
  "callback_url": "https://webhook.example.com/callback"
}

Response

Upload initiated

OR

Example response

{
  "success": true,
  "status": "processing",
  "data": {
    "id": "job-123",
    "output_url": "https://api.videodb.io/async-response/job-123"
  }
}