Skip to main content
GET
Read a channel

Authorizations

Authorization
string
header
required

A platform API key, presented as Authorization: Bearer <API_KEY>. Each operation says which permission the key needs.

Path Parameters

space_id
string<uuid>
required

The space to act in.

channel_id
string<uuid>
required

The channel's id.

Response

The channel.

A channel's configuration and lifecycle state. Its recording settings and its recordings are separate sub-resources, so listing channels stays a single query.

description
string
required
id
string<uuid>
required
name
string
required
pinned
boolean
required
read-only

Whether the channel is pinned to the top of the list. Read-only; no operation sets it.

source_id
string<uuid>
required

The live source the channel records.

status
enum<string>
required

draft is not fully configured and cannot be activated; inactive is configured but not activated; pending is being provisioned; active can record its source.

Available options:
draft,
inactive,
pending,
active
activated_at
string<date-time>
auto_shutdown
object

When the channel deactivates itself.

recording_trigger
object

The SCTE-35 cues that start and stop recording.

region
string

Where the recording worker is placed.

settings
object

How the channel behaves beyond recording. Its shape is the channel settings schema of the engine version the channel records with.

tags
string[]