Files

The files command surfaces Redmine’s project Files API, which keeps files such as release artifacts attached to a project rather than to an individual issue or wiki page.

Every subcommand needs a project. Pass --project <identifier>, or rely on the default project of the active profile (see auth).

list List the files attached to a project.

upload Upload a file from disk and attach it to a project.

list

redmine files list [flags]

Aliases: ls. Prints each file’s ID, name, size in bytes, associated version (if any), uploader, and creation timestamp.

Flag	Description
--project	Project identifier or numeric ID. Falls back to the default project of the active profile.
--limit	Maximum number of results (0 for all)
--offset	Result offset for pagination
-o, --output	Output format: table, json, csv

Default

redmine files list --project myproject

JSON

redmine files list --project myproject -o json

Paginated

redmine files list --project myproject --limit 10 --offset 20

Note

Redmine returns the project file list in a single response and ignores the server-side limit/offset parameters, so pagination is applied client-side. --limit 0 is the default behaviour and is safe to use even on busy projects.

upload

redmine files upload <path> [flags]

Aliases: add, create. Uploads a file from disk to Redmine’s /uploads.json endpoint, then attaches the resulting token to the project. Pass --version to pin the file to a milestone so it shows up in version-scoped views.

Flag	Description
--project	Project identifier or numeric ID
--filename	Override the displayed filename (defaults to the file’s base name)
--version	Attach to a version: name or numeric ID
--description	Optional description
--content-type	Override the detected MIME type
-o, --output	Output format

redmine files upload ./release.tar.gz --project myproject

redmine files upload ./changelog.md --project myproject \
  --version 1.2.0 --description "Release notes"

redmine files upload ./build.zip --project myproject --filename "build-1.2.0.zip"

Tip

Redmine returns no body on a successful upload. Run redmine files list --project myproject afterwards to confirm the new file landed and to capture its assigned ID and content URL.