Skip to content
Welcome to the new, unified Livepeer documentation! 👋
Reference
Create Asset via URL

Create Asset via URL

Import a video Asset from an external URL through the POST /api/asset/import API.

Request

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

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?

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.