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.
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 of the channel set (max 200 characters)
Description of the channel set
Array of channel IDs to include in the set
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
PATCH /api/channelset/{id}
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
DELETE /api/channelset/{id}
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
Unique identifier for the channel set
Description of the channel set
Array of channel IDs included in this set
Number of channels in the set
Unique token for sharing the channel set
Whether the channel set is publicly visible
Timestamp when the set was created
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