Skip to main content

POST Upload asset via URL

Upload a video Asset to Livepeer Studio 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?

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.