Skip to main content

Create a Stream

Creates a stream either to the specified IP address and port, or when re-streaming multisource videos, to a destinations list.

Note

For multi-source videos, the address and port are ignored, and a destinations list must be present.

Authorizations: Recordings - STREAM

Requests

Stream
POST /apis/assets/:assetId/streams
{
"address": "239.134.32.100",
"port": 4900
}
Multi-Source Video
POST /apis/assets/:assetId/streams
{
"address": "ignored",
"port": 1,
"destinations": [{
  "trackId": 3,
  "address": "239.134.32.100",
  "port": 4900
}, {
  "trackId": 4,
  "address": "239.134.32.100",
  "port": 4901
}]
}

Response

Success

Stream
{
"data": {
  "address": "239.134.32.100",
  "port": 4900,
  "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
  "username": "haiadmin",
  "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa"
}
}
Multi-Source Video
{
"data": {
  "address": "239.134.32.100",
  "port": 4900,
  "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
  "username": "haiadmin",
  "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa",
   "destinations": [{
     "trackId": 3,
     "address": "239.134.32.100",
     "port": 4900
   }]
}
}

Note

For multiple destinations, address and port are overwritten respectively to multiple and 0.

Error

Code

Payload

Description

400
{"code":"010005", "name":"MultiSourcesStream",
"message":"Multi-Source recordings must have a
destination list", "httpStatusCode":400}

You must provide a list of destinations for videos that contain multiple sources. You cannot just provide a list of IP addresses.

400
{"code":"010006", "name":"AddressPortAlreadyInUse",
"message":"Address or port already in use",
"httpStatusCode":400}

The system is already streaming to the specified IP address or port.

400
{"code":"010006", "name":"AddressPortAlreadyInUse",
"message":"Address or port already in use by a
source", "httpStatusCode":400}

The system is already configured to use a Source with the specified IP address or port.

400
{"code":"010001", "name":"InputValidation",
"message":<Error message>, "httpStatusCode":400}

Supplied data was insufficient or incorrect.

404
{"code":"040002", "name":"AssetNotFound",
"message":"Video not found", "httpStatusCode":404}

Video with UUID Id not found.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.