Channels
Ingests

Create an ingest for a channel

Changed on
post/channels/{id}/ingests

Request

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

Path parameters

idstring required

Channel ID

Request body

namestring required

Name of the ingest

type'rtmp-push' | 'rtmp-pull' | 'srt-pull' | 'srt-push' | 'sdi-pull' | 'rtsp-pull' | 'ndi-pull' required

Ingest type. Note: srt-push requires SRT push to be enabled at organization level. Currently only rtsp-pull ingests can be started/stopped via the ingest start/stop endpoints

urlstring

Source URL (required for pull types, except sdi-pull and ndi-pull). Must be a valid URL with a host, using the scheme of the ingest type ("srt://" for srt-pull, "rtmp://" or "rtmps://" for rtmp-pull, "rtsp://" for rtsp-pull). A port, if present, must be between 0 and 65535; srt-pull requires an explicit port

regionstring

Region ID. Required for srt-push and rtmp-push. Required for srt-pull and rtmp-pull when single ingest is enabled for the organization, in which case it must be a single ingest enabled region. Required and must be a DUPLO region when a 'speech' enhancement is enabled. Required and must be an on-prem region for rtsp-pull, ndi-pull and sdi-pull (ndi-pull and sdi-pull additionally require the region to support the ingest type)

Response

Ingest created

Changes

    • info

      added the non-success response with the status

    • info

      added the new optional request property //////

    • info

      added the new optional request property //////

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property ///// to the response with the status