Tool
content_channels_update
Rename a channel, change its delivery mode, turn a manual channel on or off (enabled), or correct its capability descriptor.
Rename a channel, change its delivery mode, turn a manual channel on or off (enabled), or correct its capability descriptor. Turning off is refused with 409 channel_not_toggleable for an integration channel, which is always on, and with 409 channel_has_scheduled while the channel still has publications waiting to go out — cancel them first. Channels are not created with a tool: every product starts with one per network, and each account connected on the Integrations page adds its own.
Behavior
- HTTP
PATCH /content/channels/:id
Arguments
Name | Type | Required | Description |
|---|---|---|---|
id | string | • | The channel id returned by content_channels_list. |
enabled | boolean | — | Turn a manual channel on (true) or off (false). Integration channels are always on: false is refused with channel_not_toggleable. A channel with publications still scheduled cannot be turned off: the call is refused with channel_has_scheduled until they are cancelled or have gone out. Omit to leave it as it is. |
displayName | string | — | New human label for the channel. Omit to keep the current one. |
capabilities | object | — | Override individual capability fields — a known ceiling beats the hand-filled constant. Merges over the existing descriptor; fields you omit keep their current values. |
deliveryMode | string | — | Change how the post reaches the network. Only reminder can be scheduled in this release — no publishing adapter exists yet. |
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
Rename a channel, change its delivery mode, turn a manual channel on or off (enabled), or correct its capability descriptor.