# Users Tool - Full Documentation

## Overview
User info: list, get, me, from_workspace.

## Important
- `list` and `get` require **Enterprise plan** or explicit `read_user` capability granted by workspace admin. Most integrations will get "Integration does not have ability to..." error.
- Use `me` to get the bot's own info (always works).
- Use `from_workspace` as a reliable fallback — extracts users from created_by/last_edited_by metadata in accessible pages (no special permissions needed).

## Actions

### me
```json
{"action": "me"}
```
Returns bot/integration info.

### list
```json
{"action": "list"}
```
Requires user:read permission.

### get
```json
{"action": "get", "user_id": "xxx"}
```

### from_workspace
```json
{"action": "from_workspace"}
```
Extracts users from created_by/last_edited_by in accessible pages.

## Parameters
- `user_id` - User ID (for get action)