Skip to main content
POST
/
uploads
/
from-link
Import an upload from a link
curl --request POST \
  --url https://api.streamloop.app/v1/uploads/from-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>"
}
'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "mimeType": "<string>",
  "name": "<string>",
  "uploaded": true,
  "fileSize": 123
}

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