DOdolby
Restreams

Update a restream by ID

Changed on

Only stopped restreams can be updated (409 not_stopped otherwise). The combination of type, src and target is validated as on creation: type: ingest restreams the incoming stream of an rtmp-push or srt-push ingest of the channel as-is; the target must use the same protocol as the ingest (rtmp:// or rtmps:// for rtmp-push, srt:// for srt-push). type: engine restreams the output of an engine of the channel; only rtmp:// or rtmps:// targets are supported. Returns 400 restream_source_not_found when src is not an ingest/engine of the channel, restream_source_not_supported for other ingest types and restream_target_not_supported for a protocol mismatch. Restreaming is not available for every organization, ingest or engine region (400 restream_not_supported resp. restream_source_not_supported otherwise).

patch/restreams/{id}

Request

  • Base URL
    https://api.theo.live/v2
  • Auth
    HTTP basic

Path parameters

idstring required

Restream ID

Request body

type'ingest' | 'engine'

Source type of the restream: ingest restreams the incoming stream of an rtmp-push or srt-push ingest as-is, engine restreams the transcoded output of an engine

srcstring

Id of the ingest or engine (depending on type) to restream. Must be connected to the same channel

targetstring

Push URL the stream is sent to. An ingest restream uses the protocol of its ingest (srt:// for srt-push, rtmp:// or rtmps:// for rtmp-push); an engine restream only supports rtmp:// or rtmps://

Response

Updated restream

Changes