Channels
Channels represent specific content outlets within an organization -- for example, a publication's website, newsletter, podcast, or event series. Each channel belongs to exactly one outlet.
Channel Types
The type field accepts these values:
websitenewsletterpodcasttv_broadcastprinteventaward
create_channel
Create a new channel within an outlet.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| outlet_id | string (UUID) | Yes | Parent outlet ID |
| type | string | Yes | Channel type (see list above) |
| name | string | No | Channel name (may differ from outlet) |
| description | string | No | Description |
| url | string | No | Channel-specific URL |
| frequency | string | No | daily, weekly, monthly, quarterly, annual |
| attributes | object | No | Channel-type-specific metrics (JSONB). Use for audience size, subscriber count, etc. |
Example
json
{
"name": "create_channel",
"arguments": {
"outlet_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "newsletter",
"name": "TechCrunch Daily",
"url": "https://techcrunch.com/newsletter",
"frequency": "daily",
"attributes": { "subscriber_count": 500000 }
}
}get_channel
Get a channel by ID, including its parent outlet.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Channel ID |
Example
json
{
"name": "get_channel",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}list_channels
List channels with optional filters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| outlet_id | string (UUID) | No | Filter by outlet |
| type | string | No | Filter by channel type |
| include_archived | boolean | No | Include archived channels (default: false) |
| limit | number | No | Max results (default: 50) |
| offset | number | No | Offset for pagination (default: 0) |
Example
json
{
"name": "list_channels",
"arguments": {
"outlet_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "podcast"
}
}update_channel
Update channel fields.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Channel ID |
| name | string | No | Channel name |
| description | string | No | Description |
| url | string | No | Channel URL |
| frequency | string | No | Frequency |
| attributes | object | No | Channel-type-specific metrics (JSONB) |
Example
json
{
"name": "update_channel",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"attributes": { "subscriber_count": 600000, "open_rate": 0.42 }
}
}archive_channel
Soft-delete a channel.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Channel ID |
Example
json
{
"name": "archive_channel",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}restore_channel
Restore an archived channel.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Channel ID |
Example
json
{
"name": "restore_channel",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}