Sample - Slack Web API
GET/users.conversations

List accessible conversations

Lists the conversations that the authenticated user may access. Filter by conversation types, user membership, and archived status, and use cursor to retrieve successive pages of results.

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

6 parameters
tokenstringoptional
Authentication token with the `conversations:read` scope.
userstringoptional
User ID whose conversation memberships to browse; non-public channels are limited to those shared with the authenticated user.
typesstringoptional
Comma-separated conversation types selected from `public_channel`, `private_channel`, `mpim`, and `im`.
exclude_archivedbooleanoptional
Set to true to exclude archived channels from the results.
limitintegeroptional
Maximum number of conversations to return; must be an integer no larger than 1000.
cursorstringoptional
Pagination cursor from a previous response's `response_metadata.next_cursor`; omit it to fetch the first page.

2 status codes
200Returns an array of accessible conversation objects and `response_metadata.next_cursor` for pagination. Conversation objects from this method do not include `num_members` or `is_member`.
channelsarray<array>required
okbooleanrequired
Allowed:true
response_metadataobjectoptional
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:method_not_supported_for_channel_typemissing_scopeinvalid_typesinvalid_cursorinvalid_limitnot_authedinvalid_authaccount_inactivetoken_revokedno_permissioninvalid_arg_nameinvalid_array_arg
okbooleanrequired
Allowed:false

Error handling

The optional types value accepts a comma-separated combination of public_channel, private_channel, mpim, and im; unsupported types are rejected. limit must be an integer no larger than 1000, and cursor must come from a previous next_cursor value when used.