uploads

Import uploads from a link

Confirms asset and quality selections from external-link discovery, starts asynchronous imports, and returns 202 Accepted. Poll GET /uploads/{id} and watch externalSource.state until each upload 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

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

Changes