Skip to main content

POST multistream target

POST /multistream/target creates a multistream target object.

Parameters​

Required

  • 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.

Note: Creating only a multistream target is not sufficient to start multistreaming. You also need to reference the target from the stream that you want to streamed.

You can also refer to the Multistreams guide for more information.

Example Request​

Create and name a multistream target, and reference the target from the stream that you want to streamed.

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"
}'

Response​

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"
}