Users

The users command (alias u) manages Redmine users. All write operations require admin privileges; non-admin self-service lives under my-account.

listList users with status, name, or group filters.

getView a single user by ID, login, or name.

meShow the authenticated user.

createCreate a new user account.

updateChange user fields.

deleteRemove a user account.

list

redmine users list [flags]

Flag	Description
--status	Filter by status: active, registered, locked
--name	Filter by name or login
--group	Filter by group name or ID
--limit	Maximum number of results
--offset	Result offset for pagination
-o, --output	Output format

get

redmine users get <id-or-name> [flags]

Aliases: show, view. Accepts a numeric ID, login, full name, or me.

Flag	Description
--include	Include related data: memberships, groups (repeatable or comma-separated). groups requires Redmine 2.1+.
-o, --output	Output format

me

redmine users me [flags]

Shows the authenticated user’s details — useful in scripts to resolve the current account.

Flag	Description
--include	Include related data: memberships, groups (repeatable or comma-separated).
-o, --output	Output format

users me vs my-account get

users me hits /users/current.json and returns the user record visible to the caller. my-account get hits /my/account.json, which also includes the API key and any custom fields, and is the endpoint paired with the writable self-service my-account update.

create

redmine users create [flags]

Flag	Description
--login	Login name — required
--password	Password — required unless --generate-password is set
--firstname	First name — required
--lastname	Last name — required
--mail	Email address — required
--admin	Grant admin privileges
--mail-notification	Email notification preference: all, only_my_events, only_assigned, only_owner, none
--must-change-passwd	Force the user to change their password on next login
--generate-password	Let the server generate a random password (omit --password)
--auth-source-id	Numeric authentication source ID for external auth
--send-information	Email the account info to the new user

Passwords on the command line

Passing --password on the command line may leak the value to shell history. Prefer --generate-password paired with --send-information, or pipe the password from a secure source.

update

redmine users update <id-or-name> [flags]

Accepts the same flags as create (all optional, except --send-information which is create-only). The user argument accepts a numeric ID, login, full name, or me. Only fields whose flags are explicitly set are sent to the server, so partial updates do not clobber other fields.

delete

destructive

redmine users delete <id-or-name> [flags]

Flag	Description
-f, --force	Skip confirmation prompt