v2

latestOpenAPI 3.1.02026-08-013435189.7 KB
uploads

Import an upload from a link

Starts an asynchronous import from an external URL and returns 202 Accepted. Poll GET /uploads/{id} and watch externalSource.state until it reaches completed.

post/uploads/from-link

Headers

Idempotency-Keystring

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

Request body

quality'BEST' | 'P2160' | 'P1440' | 'P1080' | 'P720' | 'P480' | 'P360' nullable

Quality preference (default BEST = peak).

type'VIDEO' | 'AUDIO' required
urlstring required

Response

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

createdAtstring date-time required
fileSizeinteger nullable
idstring required
mimeTypestring required
namestring required
type'audio' | 'video' | 'image' required
uploadedboolean required