Streams

Update stream

Changes the RTMP or RTMPS destination URL for an existing Video stream identified by ID. Use it to redirect an active room or conference broadcast without creating a second stream.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Video.

Learn more about API scopes.

put/api/video/streams/{id}

Request

  • Base URL
    https://{Your_Space_Name}.signalwire.com
  • URL
    https://{Your_Space_Name}.signalwire.com/api/video/streams/{id}
  • Auth
    HTTP basic

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of the stream.

Request body

urlstring required

RTMP or RTMPS URL. This must be the address of a server accepting incoming RTMP/RTMPS streams.

Example request

{
  "url": "rtmp://broadcaster"
}

Response

Stream response object.

idstring uuid required

Universal Unique Identifier.

urlstring nullable required

RTMP or RTMPS URL. This must be the address of a server accepting incoming RTMP/RTMPS streams.

stream_typestring nullable required

The type of stream.

widthinteger nullable required

The stream's width in pixels.

heightinteger nullable required

The stream's height in pixels.

fpsinteger nullable required

The stream's frames per second.

created_atstring date-time required

Timestamp when the stream was created.

updated_atstring date-time required

Timestamp when the stream was last updated.

Example response

{
  "url": "rtmp://broadcaster",
  "stream_type": "rtmp",
  "width": 1920,
  "height": 1080,
  "fps": 20,
  "created_at": "2022-01-01T10:00:00Z",
  "updated_at": "2022-01-01T11:00:00Z"
}

Changes

No operation changes found yet. Some revisions have not been checked.