Skip to main content
POST
Creates a new recording channel in the specified space.

Authorizations

Authorization
string
header
required

OAuth2 bearer token in the Authorization header

Path Parameters

space_id
string<uuid>
required

UP Space Id

Body

application/json
name
string
required
description
string
required
source_id
string<uuid>
required
expected_properties
string
required
continuous_recording
boolean
default:false
recording_duration
integer | null
auto_shutdown
object
recording_trigger
object
recording_settings
object
region
string | null
tags
string[]

Response

Channel created

id
string<uuid>
required
read-only
Example:

"e3c908ad-dc8f-4edb-88f7-c84dec0aef99"

name
string
required
Example:

"CNN East Recorder"

description
string
required
source_id
string<uuid>
required

ID of the live source (managed by UP.LiveSources) this channel records from.

status
enum<string>
required
read-only
Available options:
DRAFT,
INACTIVE,
PENDING,
ACTIVE,
RECORDING,
FINISHING_RECORDING,
ERROR
continuous_recording
boolean
required
expected_properties
string
required

Expected stream-properties config as a JSON string.

pinned
boolean
required
activated_at
string<date-time> | null
read-only
auto_shutdown
object
recording_duration
integer | null

Hours of available recorded window when continuous_recording is true.

recording
object
recording_settings
object
recording_trigger
object
region
string | null
errors
string[] | null
tags
string[] | null
created_at
string<date-time>
read-only
Example:

"2025-04-21T15:53:12.388317Z"

updated_at
string<date-time>
read-only
Example:

"2025-04-22T15:53:12.182617Z"