Create Stream

Create a new live stream channel.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Resource IDs

There are no list endpoints for domain restriction, geo restriction, or theming. If you are unsure which values to use for referers_id, countries_id, or theme_id, ask the team.

A successful create returns 201. Encoder settings are in config (publishing_point_primary + stream_name). Do not hardcode the ingest host; it depends on region. Do not send rendition_count.

Step-by-step: Create Live Streams Channels

For a VOD to Live channel, send vod_rebroadcast instead of encoder ingest: VOD Rebroadcast.

Body Params
string
required

Channel name

string

Short description

string
enum

Ingest location closest to the encoder. Hosts in config differ by region; do not hardcode the RTMP/SRT/WHIP URL.

Allowed:
boolean
Defaults to true

Whether the channel is enabled for playback. This is not whether someone is currently broadcasting.

boolean
Defaults to false

Record the live stream

boolean
Defaults to false

Rewind / DVR. Cannot be enabled unless live_recording_enabled is true.

string

Google Analytics measurement ID

string

Password to watch the stream

string

Domain restriction set id

string

Geo restriction set id

string

Theme id

string
enum
Defaults to transmux

Passthrough (transmux, default), transcode/ABR (sd-transcode / hd-transcode / fhd-transcode), or direct HLS ingest (hls).

Allowed:
vod_rebroadcast
object

Create or reschedule a VOD to Live channel. Omit this object for encoder ingest. Do not send timezone. See https://docs.dacast.com/docs/vod-rebroadcast

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json