list_users
List organization users with filters for status, role, department, office, permissions, and full-text search. Defaults to active users.
Instructions
List users in the organization. Defaults to active users; use the status filter to include pending, deactivated, or imported. Supports filtering by role, department, office, granted permissions, and a full-text query across name and email.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number | |
| limit | No | Items per page | |
| sort_by | No | Field to sort by (default: created_at) | |
| sort_order | No | Sort direction | |
| status | No | Comma-separated user statuses: active, pending, deactivated, imported. Defaults to active when omitted. | |
| role_id | No | Comma-separated role IDs to filter by | |
| department_id | No | Comma-separated department IDs to filter by | |
| office_id | No | Comma-separated office IDs to filter by | |
| permission | No | Comma-separated permission keys in `resource:action` format (e.g. `users:manage,jobs:read`). Matches users whose role grants any of the listed permissions. | |
| query | No | Full-text search across user name and email | |
| created_after | No | ISO 8601 datetime lower bound on created_at | |
| created_before | No | ISO 8601 datetime upper bound on created_at | |
| updated_after | No | ISO 8601 datetime lower bound on updated_at | |
| updated_before | No | ISO 8601 datetime upper bound on updated_at |