Sample - Slack Web API
GET/admin.conversations.getTeams

List workspaces connected to a channel

Lists the workspaces within an Enterprise organization to which a public or private channel is connected. Supply channel_id to identify the channel, then use cursor to retrieve additional pages. Use limit to control the page size.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 parameters
channel_idstringrequired
Identifier of the channel whose connected workspaces to retrieve.
cursorstringoptional
Pagination cursor from a previous response's `next_cursor` value.
limitintegeroptional
Maximum number of workspaces to return. Must be between 1 and 1000.
tokenstringrequired
Authentication token with the `admin.conversations:read` scope.

2 status codes
200Returns the `ok` flag, an array of connected workspace IDs in `team_ids`, and pagination metadata containing `next_cursor`.
okbooleanrequired
Allowed:true
response_metadataobjectoptional
team_idsarray<TeamID>required
defaultReturned when the request cannot be processed successfully; the response contains `ok: false` and an error value.
errorstringrequired
Allowed:feature_not_enabledchannel_not_foundchannel_type_not_supportedunsupported_team_typerestricted_actioncould_not_get_teamsinvalid_cursorinvalid_limit
okbooleanrequired
Allowed:false

Error handling

token must provide the admin.conversations:read scope, and channel_id must identify a channel. limit must be an integer from 1 through 1000; pass the returned next_cursor in cursor to continue pagination.