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.

💡
For IPFS HTTP gateway URLs, the API currently only supports “path style” URLs and does not support “subdomain style” URLs. The API will support both styles of URLs in a future update.

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.