channels_list
📋 The messaging channels connected to this workspace and whether they are working.
One row per channel account: channel, display_name, status, error, and reconnect_url when the account needs repair. A channel in status 'error' is NOT receiving messages — say so plainly and give the person reconnect_url; it opens the repair directly, so do not tell them to look for it in settings and do not build a link of your own.
Pass only_broken=true to check for outages without listing the healthy channels.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chats | No | With account_id: that account's chats, synced or NOT (search.threads sees only synced ones). A text finds the chats whose title contains it, e.g. 'showcase' finds 'Server › #showcase' of a big Discord server left out for its size; '*' lists them all. At most 50 per answer, synced first, then by kind and title; `chats_page` says total, has_more and next_offset. Each comes with thread_id, synced, why it is out of sync, member_count, and for a Discord server channel its topic, can_view and can_send (false = this account may not read / post there, null = unknown). Turn one on with threads.update(thread_id=..., synced=true). OMIT otherwise. | |
| account_id | No | One account in detail, with its large_group_threshold (groups this large are left out of sync; change it with channels.sync_settings). For a custom channel this adds whether it is listening or polling, why inbound is down, how many contacts it has, the progress of a history import, a health check and the agents that would answer on it. For Discord: whether the gateway stream is up (connected_at, last event), how many servers, server channels and DMs the account sees, how many chats are synced and the sync scope. OMIT to list the workspace's channels. | |
| only_broken | No | true = only the accounts that need attention (status 'error'). OMIT to list every channel of the workspace. | |
| chats_offset | No | With chats: skip this many chats, to read the next page (pass chats_page.next_offset). OMIT for the first page. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. |