Attachments

Attachments

Upload, download, and manage file attachments on Jira issues.

Prerequisites

• Authenticated profile (atlcli auth login)
• Jira permission: Browse Projects (view), Create Attachments (upload), Delete Attachments (delete)

List Attachments

View attachments on an issue:

atlcli jira issue attachments PROJ-123

Output:

ID          FILENAME           SIZE      CREATED
10001       screenshot.png     245 KB    2025-01-14
10002       debug.log          12 KB     2025-01-13
10003       requirements.pdf   1.2 MB    2025-01-10

Use --json for JSON output.

Upload Attachment

Attach a file to an issue:

atlcli jira issue attach PROJ-123 ./screenshot.png

Upload multiple files:

atlcli jira issue attach PROJ-123 ./file1.png ./file2.pdf ./logs.zip

Options:

Flag	Description
--comment	Add a comment with the attachment

Examples

# Upload with comment
atlcli jira issue attach PROJ-123 ./error.log --comment "Error logs from production"

# Upload all screenshots
atlcli jira issue attach PROJ-123 ./screenshots/*.png

Download Attachment

Download an attachment by ID or filename:

# By attachment ID
atlcli jira issue attachment download 10001 -o ./downloads/

# By filename from issue
atlcli jira issue attachment download PROJ-123 screenshot.png -o ./downloads/

Options:

Flag	Description
-o, --output	Output directory or file path
--overwrite	Overwrite existing files

Download All Attachments

# Download all attachments from an issue
atlcli jira issue attachments PROJ-123 --json | \
  jq -r '.attachments[].id' | \
  xargs -I {} atlcli jira issue attachment download {} -o ./downloads/

Delete Attachment

Remove an attachment:

atlcli jira issue attachment delete 10001 --confirm

Options:

Flag	Description
--confirm	Skip confirmation prompt

JSON Output

atlcli jira issue attachments PROJ-123 --json

{
  "schemaVersion": "1",
  "issue": "PROJ-123",
  "attachments": [
    {
      "id": "10001",
      "filename": "screenshot.png",
      "size": 250880,
      "mimeType": "image/png",
      "created": "2025-01-14T10:00:00Z",
      "author": {
        "displayName": "Alice",
        "email": "alice@company.com"
      },
      "content": "https://company.atlassian.net/secure/attachment/10001/screenshot.png"
    }
  ],
  "total": 1
}

Supported File Types

Jira accepts most file types. Common attachments include:

• Images: PNG, JPG, GIF, SVG
• Documents: PDF, DOCX, XLSX, TXT
• Archives: ZIP, TAR.GZ
• Logs: LOG, TXT
• Code: Source files of any type

Size Limits

Jira Cloud has a default attachment size limit of 10 MB per file. Your administrator may have configured different limits.

Use Cases

Attach Build Artifacts

# Attach build log after CI failure
atlcli jira issue attach PROJ-123 ./build.log --comment "Build failed - see attached log"

Bulk Export Attachments

# Export all attachments from issues matching JQL
for key in $(atlcli jira search --jql "project = PROJ AND attachments is not EMPTY" --json | jq -r '.issues[].key'); do
  mkdir -p "./attachments/$key"
  atlcli jira issue attachments $key --json | \
    jq -r '.attachments[].id' | \
    xargs -I {} atlcli jira issue attachment download {} -o "./attachments/$key/"
done

Migrate Attachments Between Issues

# Download from source issue
atlcli jira issue attachments PROJ-100 --json | \
  jq -r '.attachments[].id' | \
  xargs -I {} atlcli jira issue attachment download {} -o /tmp/migrate/

# Upload to target issue
atlcli jira issue attach PROJ-200 /tmp/migrate/*

Related Topics

• Issues - Work with issues
• Import/Export - Bulk data operations