Channels
Restreams

Create a restream for a channel

Changed on

A restream pushes the stream of an ingest or engine of a channel to an external RTMP or SRT destination. Restreams are only available when restreaming is enabled for the organization (403 feature_not_enabled otherwise). 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). A new restream is stopped: start it to begin pushing.

post/channels/{id}/restreams

Request

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

Path parameters

idstring required

Channel ID

Request body

type'ingest' | 'engine' required

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 required

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

targetstring required

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

Restream created

Changes