Activate a channel
Starts provisioning the channel’s recording worker. The channel is returned pending and becomes active once provisioning completes. The channel must be inactive: recording settings valid for recording are what move it out of draft. Requires the capture:access permission.
Authorizations
A platform API key, presented as Authorization: Bearer <API_KEY>. Each operation says which permission the key needs.
Path Parameters
The space to act in.
The channel's id.
Response
Activation was accepted; the channel is pending.
A channel's configuration and lifecycle state. Its recording settings and its recordings are separate sub-resources, so listing channels stays a single query.
Whether the channel is pinned to the top of the list. Read-only; no operation sets it.
The live source the channel records.
draft is not fully configured and cannot be activated; inactive is configured but not activated; pending is being provisioned; active can record its source.
draft, inactive, pending, active When the channel deactivates itself.
The SCTE-35 cues that start and stop recording.
Where the recording worker is placed.
How the channel behaves beyond recording. Its shape is the channel settings schema of the engine version the channel records with.
