list_users
Retrieve a filtered list of Redmine users by status, name, group, or login. Requires admin access to manage user accounts.
Instructions
Lists users in Redmine with optional filters. Requires admin privileges.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | Number of items to skip (default 0) | |
| limit | No | Number of items per page (default 25, max 100) | |
| include | No | Comma-separated: auth_source | |
| status | No | Filter by status. Values: 1=active, 2=registered, 3=locked. Operators: = (default), ! (not equal). Examples: 1, 1|2, !3 | |
| name | No | Filter by name, login, or email (contains search). Examples: john, admin | |
| group_id | No | Filter by group membership. Value is the group ID | |
| login | No | Filter by login. Operators: ~ (contains), = (exact), ! (not equal), ^ (starts with), $ (ends with) | |
| firstname | No | Filter by first name. Operators: ~ (contains), = (exact), ! (not equal), ^ (starts with), $ (ends with) | |
| lastname | No | Filter by last name. Operators: ~ (contains), = (exact), ! (not equal), ^ (starts with), $ (ends with) | |
| No | Filter by email address. Operators: ~ (contains), = (exact), ! (not equal), ^ (starts with), $ (ends with) | ||
| admin | No | Filter by admin privilege: 1=admin, 0=non-admin | |
| auth_source_id | No | Filter by authentication source. Operators: = (default), ! (not equal), * (any), !* (none) | |
| twofa_scheme | No | Filter by two-factor authentication scheme. Operators: = (default), ! (not equal), * (any), !* (none) | |
| created_on | No | Filter by creation date. Examples: >=2024-01-01, >t-30, lm | |
| last_login_on | No | Filter by last login date. Examples: >=2024-01-01, >t-30, !* (never logged in) |