Livepeer Studio

POST create a multistream target

POST /multistream/target creates a multistream target object. The only parameter you are required to set is the url of your target. The name will be derived from the url host, if not specified.

Notice that only creating a multistream target is not enough for multistream to start happening. You also need to reference the target from the stream that you want to be multistreamed. Refer to Multistream guide for more information.

Here is an example request:

curl -X POST 'https://livepeer.studio/api/multistream/target' \
-H 'content-type: application/json' \
-H 'authorization: Bearer {api-key}' \
-d '{
    "name": "My Multistream Target",
    "url": "rtmp://rtmp.streaming.tv/live/SECRET"
}'

201 Created

{
  "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaa",
  "userId": "bbbbbbbb-bbbb-bbbb-bbbb-bbbb",
  "name": "My Multistream Target",
  "url": "rtmp://rtmp.streaming.tv/live/SECRET"
}