Skip to main content
POST
/
enterprise
/
api
/
upload_media
Upload media file
curl --request POST \
  --url https://api.viddyscribe.com/enterprise/api/upload_media \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form file='@example-file' \
  --form filename=my-video.mp4
{
  "media_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "created",
  "duration_seconds": 45.5,
  "frame_rate": 30
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Body

multipart/form-data
file
file
required

Video file to upload

filename
string

Optional custom filename

Response

Media uploaded successfully

media_id
string<uuid>

Unique identifier for the uploaded media

status
enum<string>

Upload status

Available options:
created
duration_seconds
number | null

Video duration in seconds

frame_rate
number | null

Video frame rate (fps)