> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# conversations_list

> List channels in the workspace. Use this to resolve a channel name to the channel ID that every other Slack tool expects.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://slack.com/api/conversations.list"}</code></div>

```python slack_conversations_list.py theme={null}
from charter.packs import slack

result = await slack.conversations_list.ainvoke({})
```

<Note>
  Requires `chat:write`, `channels:read`, `groups:read`, `im:read`, `mpim:read`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `users:read`, `reactions:write`. Pages by cursor: `response_metadata.next_cursor` is sent back as `cursor`.
</Note>

## Query parameters

<div className="reference-table">
  | Field             | Type      | Description                                                                                                                                                                                                                                                |
  | ----------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `types`           | `string`  | Mix and match channel types by providing a comma-separated list. Valid values: 'public\_channel', 'private\_channel', 'mpim', 'im'. For example 'public\_channel,private\_channel'. Defaults to 'public\_channel'.                                         |
  | `excludeArchived` | `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 has not been reached. Must be an integer under 1000. <span className="field-constraints">≥ 1; ≤ 999; defaults to `100`</span> |
  | `cursor`          | `string`  | Paginate through collections of data by setting this to the next\_cursor attribute returned by a previous request's response\_metadata.                                                                                                                    |
  | `teamId`          | `string`  | Encoded team id to list channels in. Required if the token belongs to an org-wide app.                                                                                                                                                                     |
</div>