POST Upload asset via URL

Upload a video Asset to Livepeer Studio from an external URL through the POST /api/asset/upload/url API.

Request

curl

curl --location --request POST 'https://livepeer.studio/api/asset/upload/url' \
--header 'Authorization: Bearer $API_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url":"$EXTERNAL_URL",
    "name":"Example name"
}'

javascript

const response = await fetch("https://livepeer.studio/api/asset/upload/url", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${api_key}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "$EXTERNAL_URL"
      name: "Example name",
    }),
  })

const result = await response.json();

Response

{
    "asset": {
        "id": "7d042176-230b-464c-a677-4a19b513193c",
        "playbackId": "7d048tbcfrv6gvzs",
        "userId": "80dc8f6e-69d5-401f-bbd7-bfc09a2a5320",
        "createdAt": 1659715086322,
        "status": {
            "phase": "waiting",
            "updatedAt": 1659715086322
        },
        "name": "Example name"
    },
    "task": {
        "id": "d3a2ab1b-8dd1-450d-ac8e-498fd9d91865"
    }
}

How do I upload a livestream into my assets?

Livepeer Studio's livestream recordings are automatically uploaded as Asset objects. All you need to do is enable recording on your streams.

When the stream session ends, the platform waits 6min to give a chance for the user to reconnect on the same recording session. After that delay, the recording is processed and you should have a new asset in your account which you can retrieve from the list assets API.