Skip to main content
POST
/
enterprise
/
api
/
upload_from_url
Upload media from URL
curl --request POST \
  --url https://api.viddyscribe.com/enterprise/api/upload_from_url \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source_url": "https://example.com/video.mp4",
  "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

application/json
source_url
string<uri>
required

Publicly accessible video URL

Example:

"https://example.com/video.mp4"

filename
string

Optional custom filename

Example:

"my-video.mp4"

Response

Media uploaded successfully

media_id
string<uuid>

Unique identifier for the uploaded media

status
enum<string>

Upload status (existing if deduplicated)

Available options:
created,
existing
duration_seconds
number | null

Video duration in seconds

frame_rate
number | null

Video frame rate (fps)