Memberships

The memberships command (alias m) manages project memberships — the mapping between users/groups and project roles.

listList memberships for a project.

getView a single membership.

createAdd a user or group with roles.

updateChange the assigned roles.

deleteRemove a membership.

list

redmine memberships list --project <identifier> [flags]

Flag	Description
--project	Project name, identifier, or ID — falls back to the default project of the active profile
--limit	Maximum number of results
--offset	Result offset for pagination
-o, --output	Output format: table, json, csv

get

redmine memberships get <id> [flags]

Aliases: show, view.

Flag	Description
-o, --output	Output format

create

redmine memberships create [flags]

Adds a user or group to a project with the specified roles.

Flag	Description
--project	Project name, identifier, or ID — falls back to the default project of the active profile
--user-id	User ID to add
--group-id	Group ID to add
--role-ids	Comma-separated role IDs
--roles	Comma-separated role names or IDs — required when --role-ids is omitted
-o, --output	Output format

Note

Exactly one of --user-id or --group-id must be supplied, and exactly one of --role-ids or --roles must be supplied. Use redmine roles list to discover valid role names and IDs.

update

redmine memberships update <id> [flags]

Only the assigned roles can be changed on an existing membership.

Flag	Description
--role-ids	Comma-separated role IDs
--roles	Comma-separated role names or IDs — required when --role-ids is omitted

delete

destructive

redmine memberships delete <id> [flags]

Flag	Description
-f, --force	Skip confirmation prompt