> ## 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.

# users_list

> List members of the workspace. Use this to resolve a person's name to the user ID that Slack mentions and filters expect.

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

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

result = await slack.users_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                                                                                                                                                                                                                                                                                                                      |
  | --------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `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 users list has not been reached. Providing no limit value will result in Slack attempting to deliver you the entire result set. <span className="field-constraints">≥ 1; ≤ 200; 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.                                                                                                                                                                                          |
  | `includeLocale` | `boolean` | Set this to true to receive the locale for users. Defaults to false.                                                                                                                                                                                                                                                             |
  | `teamId`        | `string`  | Encoded team id to list users in. Required if the token belongs to an org-wide app.                                                                                                                                                                                                                                              |
</div>