Users

Users Conversations

GET
/users.conversations

List conversations the calling user may access.

Authorization

slackAuth channels:read, groups:read, im:read, mpim:read
AuthorizationBearer <token>

In: header

Scope: channels:read, groups:read, im:read, mpim:read

Query Parameters

token?string

Authentication token. Requires scope: conversations:read

user?string

Browse conversations by a specific user ID's membership. Non-public channels are restricted to those where the calling user shares membership.

types?string

Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im

exclude_archived?boolean

Set to true to exclude archived channels from the list

limit?integer

The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer no larger than 1000.

Formatint32
cursor?string

Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection.

Header Parameters

Content-Type*"application/x-www-form-urlencoded"

Value in

  • "application/x-www-form-urlencoded"

Response Body

application/json

application/json

curl -X GET "https://example.com/users.conversations" \  -H "Content-Type: application/x-www-form-urlencoded"
{  "channels": [    null  ],  "ok": "True",  "response_metadata": {    "next_cursor": "string"  }}