Stream Management

Create Stream SMIL Configuration

post

Creates a Stream and its SMIL configuration. Available for Streaming (RTMP) Resources.

Path parameters

organization_uuidstringRequired

Unique identifier of the organization.

Example: ****-*****-****-****

resource_uuidstringRequired

Unique identifier of the Streaming CDN Resource.

Example: ****-*****-****-*****

Body

application/json

stream_namestring · min: 3 · max: 255RequiredExample: streamsmil

Responses

200

Returns the created Stream and SMIL configuration.

application/json

post

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream

HTTPcURLJavaScriptPython

POST /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "stream_name": "streamasmil",
  "smils": [
    {
      "smil_name": "smil",
      "qualities": [
        {
          "video_bitrate": 121321,
          "audio_bitrate": 12321312,
          "width": 123123,
          "height": 12312321
        }
      ]
    }
  ]
}

200

Returns the created Stream and SMIL configuration.

{
  "status": true,
  "data": {
    "stream_id": 54,
    "stream_name": "streamsmil",
    "stream_url": "rtmp://origin-l.glb.mncdn.com/test/streamsmil",
    "backup_url": "rtmp://origin-l-backup.glb.mncdn.com/test/streamsmil",
    "stream_hls_url": "https://OXmLWgYDSc.mncdn.com/test/streamsmil/index.m3u8",
    "smils": [
      {
        "smil_name": "smil",
        "qualities": [
          {
            "video_bitrate": 121321,
            "audio_bitrate": 12321312,
            "width": 123123,
            "height": 12312321
          }
        ],
        "smil_id": 63,
        "stream_name": null,
        "resource_uuid": null,
        "stream": null
      }
    ]
  }
}

Update Stream and SMIL Configuration

put

Updates the specified Stream and its SMIL configuration. Available for Streaming (RTMP) Resources.

Path parameters

organization_uuidstringRequired

Unique identifier of the organization.

resource_uuidstringRequired

Unique identifier of the Streaming CDN Resource.

stream_idintegerRequired

Unique identifier of the Stream to update.

Body

application/json

stream_namestringOptionalExample: updatedStream

Responses

200

Returns the updated Stream details.

application/json

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}

HTTPcURLJavaScriptPython

PUT /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 920

{
  "stream_name": "updatedStream",
  "smils": [
    {
      "smil_name": "updatedSmil",
      "stream_id": 54,
      "qualities": [
        {
          "video_bitrate": 150000,
          "audio_bitrate": 128000,
          "width": 1920,
          "height": 1080
        }
      ],
      "smil_id": 63,
      "stream_name": "updatedStreamName",
      "resource_uuid": "****-****-***-****",
      "stream": {
        "id": 55,
        "stream_name": "updatedStreamName",
        "resource_uuid": "****-****-***-****",
        "input_frame_rate": 60,
        "input_width": 1280,
        "input_height": 720,
        "audio_sample_rate": 44100,
        "audio_channels": "Stereo",
        "audio_bit_rate": 128,
        "outputs": [
          {
            "bitrate": 1000000,
            "picture_aspect_ratio": 16.9,
            "width": 1280,
            "height": 720
          }
        ],
        "profile": "Main",
        "level": 4,
        "key_frame": 4,
        "stream_url": "rtmp://origin-l.glb.mncdn.com/updatedStream/streamName",
        "backup_url": "rtmp://origin-l-backup.glb.mncdn.com/updatedStream/streamName",
        "created_at": "2024-12-29T18:00:00.000000Z",
        "updated_at": "2024-12-29T18:00:00.000000Z",
        "stream_hls_url": "https://example.mcdn.com/updatedStream/streamName/index.m3u8"
      }
    }
  ]
}

200

Returns the updated Stream details.

{
  "status": true,
  "data": [
    {
      "id": 55,
      "stream_name": "updatedStreamName",
      "resource_uuid": "****-****-***-****",
      "input_frame_rate": 60,
      "input_width": 1280,
      "input_height": 720,
      "audio_sample_rate": 44100,
      "audio_channels": "Stereo",
      "audio_bit_rate": 128,
      "outputs": [
        {
          "bitrate": 1000000,
          "picture_aspect_ratio": 16.9,
          "width": 1280,
          "height": 720
        }
      ],
      "profile": "Main",
      "level": 4
    }
  ]
}

Delete Stream

delete

Deletes the specified Stream. Available for Streaming (RTMP) Resources.

Path parameters

organization_uuidstringRequired

Unique identifier of the organization.

resource_uuidstringRequired

Unique identifier of the Streaming CDN Resource.

stream_idintegerRequired

Unique identifier of the Stream to delete.

Responses

200

Returns a confirmation indicating that the Stream was deleted.

application/json

delete

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id}

HTTPcURLJavaScriptPython

DELETE /api/v1/cdn/{organization_uuid}/resource/{resource_uuid}/stream/{stream_id} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

200

Returns a confirmation indicating that the Stream was deleted.

{
  "status": true,
  "data": true
}