Skip to main content
GET
Get the connected Slack bot's bounded channel-selection catalog

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Path Parameters

connectionId
string<uuid>
required

Slack integration connection identifier.

Response

The channels a Slack connection's bot is a member of, read live from Slack with a short cache. Returned to populate the channel picker when creating or editing a Slack trigger binding; the binding itself still stores the channel id.

The channels a Slack connection's bot is a member of, read live from Slack with a short cache. Returned to populate the channel picker when creating or editing a Slack trigger binding; the binding itself still stores the channel id.

channels
object[]
required

Bounded channel-selection catalog, sorted by name. A channel the bot has not been invited to is never listed; invite it in Slack first. Check truncated before treating absence as meaningful.

Maximum array length: 1000
fetchedAt
string<date-time>
required

When this list was read from Slack (RFC 3339). Lists are cached briefly, so a channel joined a moment ago may not appear yet.

stale
boolean
required

True when Slack could not be asked and an expired cached list was served instead. Check retryAfterSeconds before retrying.

truncated
boolean
required

True when the listing stopped at a size budget while Slack still had more channels; channels past the budget are absent, so a missing channel does not mean the bot is not a member.

retryAfterSeconds
integer

How long to wait before asking again, when the list is stale because Slack throttled the read.