Attachments

The attachments command (aliases attachment, a) surfaces Redmine’s Attachments API so you can inspect an attachment’s metadata and download its bytes. Downloads reuse the active profile’s server and API key, streaming straight to disk - no curl, no manually extracted key.

getPrint attachment metadata (filename, size, type, author).

downloadDownload the file to disk or stream it to stdout.

Tip

Don’t know the attachment ID? List an issue’s attachments with redmine issues get <id> --attachments - it prints each attachment’s ID, filename, size, and content type.

get

redmine attachments get <id> [flags]

Aliases: show, view, metadata. Fetches the attachment’s ID, filename, size, content type, description, author, and creation time via GET /attachments/:id.json. Table output also shows the download URL (when present); json returns every field, including content_url.

Flag	Description
-o, --output	Output format: table, json, csv

Table

redmine attachments get 42

JSON

redmine attachments get 42 -o json

CSV

redmine attachments get 42 -o csv

download

redmine attachments download <id> [flags]

Aliases: dl, get-file. Streams the attachment’s raw bytes to disk (or stdout), authenticating with the active profile. The response is streamed, never buffered entirely in memory, so large files are safe.

Flag	Description
-d, --dir	Directory to save into, using the attachment’s real filename (created if missing)
--path	Exact destination file path. Use - to stream to stdout
-o, --output	Confirmation format: json prints a result object; otherwise a human line is written to stderr

With no destination flag, the file is saved as ./<filename> in the current directory.

Note

Unlike most commands, -o/--output here controls only the confirmation output, not where the bytes go - use --dir / --path for that. When streaming to stdout (--path -), the bytes go to stdout and the confirmation always goes to stderr, so the pipe stays clean even with -o json.

Current dir

# Saves ./<filename>
redmine attachments download 42

Into a directory

redmine attachments download 42 --dir ./downloads

Exact path

redmine attachments download 42 --path ./logo.png

Pipe to stdout

redmine attachments download 42 --path - | file -

JSON result

redmine attachments download 42 --dir ./downloads -o json

Tip

To grab every attachment of an issue in one step, use redmine issues get <id> --download-attachments <dir>.