Tool
content_channels_get
Read one channel: its delivery mode and its capability descriptor — the character limit, media rules and cost to check before composing a variant for it.
Read one channel: its delivery mode and its capability descriptor — the character limit, media rules and cost to check before composing a variant for it.
Behavior
- HTTP
GET /content/channels/:id
Arguments
Name | Type | Required | Description |
|---|---|---|---|
id | string | • | The channel id returned by content_channels_list. |
Response
Field | Type | Always | Description |
|---|---|---|---|
id | string | • | Channel id — pass this to content_publications_schedule. |
origin | string | — | integration: the channel appeared by itself from an account connected on the Integrations page. manual: a seeded channel, or one bound by hand. |
enabled | boolean | • | Whether this channel is in use. An integration channel is always true. A manual channel is true once someone turns it on with content_channels_update (a new product starts with every manual channel off). Nothing can be scheduled on a channel that is off: content_publications_schedule refuses it with channel_disabled. |
network | string | • | Social network: linkedin, x, youtube, instagram, reddit, facebook, tiktok, threads, pinterest, bluesky or telegram. |
pausedAt | string | • | ISO-8601 time the connector stopped working, or null when healthy. A paused channel keeps its scheduled publications — they are frozen, not cancelled, and dispatch once it resumes. |
createdAt | string | • | ISO-8601 creation time. |
updatedAt | string | • | ISO-8601 time of the last change. |
connectorId | string | • | Platform connector this channel publishes through, or null for a reminder channel that needs none. An id — this toolkit never holds social credentials; a token is fetched per call and discarded. |
displayName | string | • | Human label for the channel. |
networkName | string | • | The network as a person names it — LinkedIn, X, YouTube. Use it to label a network; displayName is the account or channel name. |
pauseReason | string | • | Why it paused: revoked (access was taken away), expired (the credential ran out), detached (the integration was detached from this product), removed (the integration was deleted), or the provider reason code from a failed publish. Null when healthy. |
subjectType | string | • | Who publishes: member (a personal account) or organization (a company page). Phase 1 channels are all member accounts. |
capabilities | object | • | What the channel accepts and what it costs: maxTextLength, maxMedia, supportsVideo, supportsLink, costPerPostUsd, costPerLinkPostUsd, dailyPostCeiling, ceilingIsRuntimeData, acceptsCover (whether the cover of an output is set on the network automatically — the YouTube thumbnail) and coverMaxBytes (the largest cover it takes, or null). Read maxTextLength before writing a per-channel text variant. |
deliveryMode | string | • | How the post reaches the network: auto (this API publishes it) or reminder (the system prepares it and notifies a person, who publishes by hand). Every seeded channel is reminder. |
Try it
Read one channel: its delivery mode and its capability descriptor — the character limit, media rules and cost to check before composing a variant for it.