Skip to main content
POST
/
enterprise
/
api
/
upload_media
Upload media file or URL
curl --request POST \
  --url https://api.viddyscribe.com/enterprise/api/upload_media \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {
    "type": "url",
    "url": "<string>",
    "filename": "<string>"
  }
}
'
{
  "media_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "created",
  "duration_seconds": 45.5,
  "frame_rate": 30
}

​
Usage Examples

​
1. Upload from URL

Ingest a video from a public URL. 
curl -X POST https://api.viddyscribe.com/enterprise/api/upload_media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "type": "url",
      "url": "https://example.com/video.mp4"
    }
  }'

​
2. Upload Local File

Upload a video file directly. 
curl -X POST https://api.viddyscribe.com/enterprise/api/upload_media \
  -H "X-API-Key: YOUR_API_KEY" \
  -F 'input={"type": "file"}' \
  -F "file=@/path/to/video.mp4"

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Body

​
input
object
required

Input source definition

Response

Media uploaded successfully

​
media_id
string<uuid>

Unique identifier for the uploaded media

​
status
enum<string>

Upload status

Available options:
created,
existing
​
duration_seconds
number | null

Video duration in seconds

​
frame_rate
number | null

Video frame rate (fps)