Skip to main content
Channel Sets allow you to group related channels into collections. This is useful for organizing channels by theme, project, grade level, or other criteria.

Endpoints

List Channel Sets

curl -H "Authorization: Token YOUR_TOKEN" \
  https://studio.learningequality.org/api/channelset
Retrieve all channel sets accessible to the authenticated user.
public
boolean
Filter by public visibility
[
  {
    "id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "name": "Grade 6 Math Curriculum",
    "description": "Complete math resources for 6th grade",
    "channels": [
      "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "b2c3d4e5-f6a7-8901-bcde-f12345678901"
    ],
    "count": 2,
    "secret_token": "abc123def456",
    "public": false,
    "created": "2024-01-01T00:00:00Z",
    "modified": "2024-01-15T10:30:00Z"
  }
]

Create Channel Set

curl -X POST \
  -H "Authorization: Token YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Science Resources",
    "description": "Biology, Chemistry, and Physics channels",
    "channels": ["channel-id-1", "channel-id-2"],
    "public": false
  }' \
  https://studio.learningequality.org/api/channelset
Create a new channel set.
name
string
required
Name of the channel set (max 200 characters)
description
string
Description of the channel set
channels
array
Array of channel IDs to include in the set
public
boolean
Whether the channel set is publicly visible (default: false)

Get Channel Set

curl -H "Authorization: Token YOUR_TOKEN" \
  https://studio.learningequality.org/api/channelset/c1d2e3f4-a5b6-7890-cdef-123456789012
Retrieve details of a specific channel set.

Update Channel Set

curl -X PATCH \
  -H "Authorization: Token YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Science Resources",
    "channels": ["channel-id-1", "channel-id-2", "channel-id-3"]
  }' \
  https://studio.learningequality.org/api/channelset/c1d2e3f4-a5b6-7890-cdef-123456789012
Update an existing channel set.

Delete Channel Set

curl -X DELETE \
  -H "Authorization: Token YOUR_TOKEN" \
  https://studio.learningequality.org/api/channelset/c1d2e3f4-a5b6-7890-cdef-123456789012
Delete a channel set. This does not delete the channels themselves, only the grouping.

Channel Set Object

id
string
Unique identifier for the channel set
name
string
Name of the channel set
description
string
Description of the channel set
channels
array
Array of channel IDs included in this set
count
integer
Number of channels in the set
secret_token
string
Unique token for sharing the channel set
public
boolean
Whether the channel set is publicly visible
created
string
Timestamp when the set was created
modified
string
Timestamp when the set was last modified

Use Cases

Curriculum Collections

Group channels by:
  • Grade level (“Grade 6 Resources”, “High School Science”)
  • Subject area (“Mathematics”, “Language Arts”)
  • Educational standard (“Common Core Aligned”, “NGSS Science”)

Project Organization

Organize channels for:
  • Specific initiatives or programs
  • Regional deployments
  • Partner organizations

Sharing Collections

Share curated channel collections:
  • Generate a secret token for private sharing
  • Make collections public for discovery
  • Distribute related channels as a package

Next Steps

Channels API

Manage individual channels

Bookmarks

Save channels for quick access

Catalog

Browse public channel collections

Build docs developers (and LLMs) love