Skip to main content
POST
Import an upload from a link

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization-code flow with PKCE.

Headers

Idempotency-Key
string

Optional client-generated key. A repeated request with the same key replays the original response (within 24h) instead of re-executing — safe retries.

Body

application/json
type
enum<string>
required
Available options:
VIDEO,
AUDIO
url
string
required
quality
enum<string> | null

Quality preference (default BEST = peak).

Available options:
BEST,
P2160,
P1440,
P1080,
P720,
P480,
P360

Response

Accepted — the request was accepted for asynchronous processing; poll the resource for completion.

createdAt
string<date-time>
required
id
string
required
mimeType
string
required
name
string
required
type
enum<string>
required
Available options:
audio,
video,
image
uploaded
boolean
required
fileSize
integer | null