Skip to main content

Frequency Documentation

Unscheduled Live

Hostname

https://prd-freq.frequency.com/api/2.2

Linear Channel Details

Return channel details associated to the account

Fields returned: title, description, internal_title, status, linear_channel_id, linear_channel_override_status

Endpoint

GET /linear_channels

Parameters

Description

Data Type

Example

status

Optional. Returns channels based on their status. Accepted values:

  • All (default)

  • ERROR

  • OFFLINE

  • ON_AIR

  • PENDING_OFFLINE

  • PENDING_ON_AIR

string

status=ON_AIR

sort

Optional. Sorts list of channels by the following accepted values:

  • lastModifiedDate.desc (default)

  • lastModifiedDate

  • createdDate

  • title

  • linearChannelId

string

sort=lastModifiedDate.asc

linear_channel_name

Optional. Search a specific channel name.

string

linear_channel_name=My Channel Title

Request

Example

curl --location --request GET 'https://prd-freq.frequency.com/api/2.2/linear_channels?sort=lastModifiedDate.asc&status=ON_AIR&linear_channel_name=My Channel Title' \
--header 'Content-Type: application/json' \
--header 'x-frequency-auth: dd61135eba-2c1cc8e4-37cc5e-3d54e0c2' \
--header 'x-frequency-deviceid: 8b7f9c2d-4a16-b8e5'

Response

Body

Switch Channels to Live

Bulk switch channels to live using an HLS url in the request payload. This will add a program to the schedule, so the fields sent in the request actually reflect the program title/description, not linear channel title/description. Response will still return channel information as well.

FIelds returned: title, description, url, linear_channel_id, linear_channel_override_status, status

Endpoint

POST /linear_channels/override

Request

Example

curl --location --request POST 'https://prd-freq.frequency.com/api/2.2/linear_channels/override' \
--header 'Content-Type: application/json' \
--header 'x-frequency-auth: dd61135eba-2c1cc8e4-37cc5e-3d54e0c2' \
--header 'x-frequency-deviceid: 8b7f9c2d-4a16-b8e5'
--data '[
  {
    "title": "My Live Event",
    "description": "What will display on the EPG output.",
    "url": "http://test-freq-sbg-id3-transformation.frequency.com/output.m3u8",
    "linear_channel_id": "1589"
  },
  {
    "title": "LIVE: Playoffs Match Game 5",
    "description": "For the division championships!",
    "url": "http://test-freq-sbg-id3-transformation.frequency.com/output.m3u8",
    "linear_channel_id": "1430"
  }
]'

Response

Body

Switch to Rescue Slate

Changes the stream to the technical difficulties fallback asset.

Fields returned: title, description, url, linear_channel_id, linear_channel_override_status, status

Endpoint

POST /linear_channels/override/rescue_slate

Request

Example

curl --location --request POST 'https://prd-freq.frequency.com/api/2.2/linear_channels/override/rescue_slate' \
--header 'Content-Type: application/json' \
--header 'x-frequency-auth: dd61135eba-2c1cc8e4-37cc5e-3d54e0c2' \
--header 'x-frequency-deviceid: 8b7f9c2d-4a16-b8e5'
--data '[
  {
    "linear_channel_id": "1589"
  },
  {
    "linear_channel_id": "1430"
  }
]'

Response

Body

Return to Schedule

Bulk channel return to schedule. Synchronization with Unscheduled Live Switching with Studio front-end.

Fields returned: title, description, url, linear_channel_id, linear_channel_override_status, status

Endpoint

POST /linear_channels/return_to_schedule

Request

Example

curl --location --request POST 'https://prd-freq.frequency.com/api/2.2/linear_channels/return_to_schedule' \
--header 'Content-Type: application/json' \
--header 'x-frequency-auth: dd61135eba-2c1cc8e4-37cc5e-3d54e0c2' \
--header 'x-frequency-deviceid: 8b7f9c2d-4a16-b8e5'
--data '[
  {
    "linear_channel_id": "1589"
  },
  {
    "linear_channel_id": "1430"
  }
]'

Response

Body

In this section: