Managing Series & Episodes

Content in the RokuChannel Platform is organized as a hierarchy: Channels contain Series, and Series contain Episodes. Each Episode is a learning unit with video, homework, and test components.

Content Hierarchy

Adding a Series

Series are managed through the COLLECTIONS API as child collections under a channel. They act as "seasons" in the Roku feed.

1. Open a Channel

   Navigate to Channels and click on the channel you want to add a series to. This takes you to the channel detail page.

2. Click "Add Series"

   On the channel detail page, click the Add Series button. Enter the series name and an optional description.

3. Configure the Series

   Set the series order, description, and any metadata. The series is created as a child collection under the channel's backing collection.

Adding Episodes

1. Navigate into a Series

   From the channel detail, click a series to view its episodes page at /series/{series_id}/episodes.

2. Click "Add Episode"

   Enter the episode title, description, and episode number. The episode is created as an item in the COLLECTIONS API.

3. Configure Episode Content

   Once created, click the episode to go to its detail page /episodes/{episode_id}. Here you can manage three tabs: Video, Homework, and Test.

Reordering Episodes

Episode order determines viewing sequence for students and the season/episode structure in the Roku feed.

# Reorder episodes within a series
curl -X PUT http://localhost:8050/api/collections/{series_collection_id}/items/reorder \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "item_ids": [
      "episode-uuid-3",
      "episode-uuid-1",
      "episode-uuid-2"
    ]
  }'

Episode Detail Page

The episode detail page at /episodes/{episode_id} provides three tabs for managing episode content: