Versions

The versions command (alias v) manages project versions — the Redmine equivalent of milestones.

create Create a project version.

list List versions for a project.

get View a single version by ID or name.

update Update a project version.

delete Delete a project version.

create

redmine versions create --name <name> [flags]

Aliases: new.

Flag	Description
--project	Project identifier — falls back to the default project of the active profile
--name	Version name (required)
--status	Status: open, locked, closed
--sharing	Sharing: none, descendants, hierarchy, tree, system
--due-date	Due date (YYYY-MM-DD or today)
--description	Version description
--wiki-page-title	Associated wiki page title
-o, --output	Output format

redmine versions create --project myproject --name 1.2.0 --due-date 2026-06-30

list

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

Flag	Description
--project	Project identifier — falls back to the default project of the active profile
--status	Filter by status: open, locked, closed
--limit	Maximum number of results
--offset	Result offset
-o, --output	Output format

redmine versions list --project myproject --status open

get

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

Aliases: show, view. Accepts a numeric ID or a version name.

Flag	Description
--project	Project identifier (used for name resolution; falls back to the default project)

Note

When resolving a version by name, a project must be known. The CLI uses --project if supplied, otherwise the default_project from the active profile.

update

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

Aliases: edit. Accepts a numeric ID or a version name.

Flag	Description
--project	Project identifier (used for name resolution; falls back to the default project)
--name	New version name
--status	New status: open, locked, closed
--sharing	New sharing: none, descendants, hierarchy, tree, system
--due-date	New due date (YYYY-MM-DD or today)
--description	New version description
--wiki-page-title	New associated wiki page title

redmine versions update 42 --status closed
redmine versions update 1.2.0 --project myproject --due-date 2026-07-15

delete

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

Aliases: rm. Accepts a numeric ID or a version name.

Flag	Description
--project	Project identifier (used for name resolution; falls back to the default project)
--force	Delete without asking for confirmation

redmine versions delete 42
redmine versions delete 1.2.0 --project myproject --force

Caution

Deleting a version is destructive. Without --force, the CLI asks for confirmation before sending the delete request.