List available channels
List available channels/chats for a connected integration.
Also returns the connection’s currently-selected IDs so a picker can render the right boxes pre-checked without a second round trip.
Authorizations
API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.
Path Parameters
Query Parameters
The connection ID to use for listing channels
For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected ids in the response always reflect the leaf values stored in user_options.channels regardless of which level is queried.
Response
Successful Response
IDs currently in connection.user_options.channels — pre-checked in pickers.
True while the provider's channel list is being walked in the background (large workspaces can take a minute) — poll again shortly; channels is empty and NOT the workspace's real state while pending.