v38

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1793196344.2 KB
Integrations
Integrations

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.

get/integrations/{integration_id}/channels

Path parameters

integration_idstring required

Query parameters

connection_idstring required

The connection ID to use for listing channels

The connection ID to use for listing channels

parent_idstring nullable

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.

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

selectedstring[]

IDs currently in connection.user_options.channels — pre-checked in pickers.