Confluence Attachment Skill

Manage file attachments on Confluence pages.

---

⚠️ PRIMARY USE CASE

This skill manages files attached to Confluence pages. Use for:

• Uploading files to pages
• Downloading attachments
• Listing files on a page
• Deleting attachments

---

When to Use / When NOT to Use

Use This Skill	Use Instead
Upload/download files	-
List page attachments	-
Delete attachments	-
Create/edit pages	confluence-page
Search for content	confluence-search

---

Risk Levels

Operation	Risk	Notes
List/download	-	Read-only
Upload	-	Can be deleted
Update	⚠️	Replaces existing file
Delete	⚠️⚠️	No recovery

---

CLI Commands

confluence attachment upload

Upload a file to a page.

Usage:

confluence attachment upload PAGE_ID FILE_PATH
confluence attachment upload 12345 report.pdf
confluence attachment upload 12345 image.png --comment "Screenshot"
confluence attachment upload 12345 data.csv --output json

Options:

• --comment - Comment describing the attachment
• --output, -o - Output format: text (default) or json

confluence attachment download

Download an attachment.

Usage:

confluence attachment download ATTACHMENT_ID --output ./downloads/
confluence attachment download att123456 --output myfile.pdf
confluence attachment download 12345 --all --output ./downloads/  # Download all from page

confluence attachment list

List attachments on a page.

Usage:

confluence attachment list 12345
confluence attachment list 12345 --output json
confluence attachment list 12345 --output table
confluence attachment list 12345 --media-type application/pdf
confluence attachment list 12345 --limit 50

Options:

• --output, -o - Output format: text, json, or table
• --media-type - Filter by media type (e.g., application/pdf)
• --limit - Maximum number of results (default 25, max 250)

confluence attachment delete

Remove an attachment.

Usage:

confluence attachment delete ATTACHMENT_ID
confluence attachment delete ATTACHMENT_ID --force
confluence attachment delete ATTACHMENT_ID --purge --force

Options:

• --force, -f - Skip confirmation prompt
• --purge - Permanently delete (otherwise moves to trash)

confluence attachment update

Replace an attachment file.

Usage:

confluence attachment update ATTACHMENT_ID FILE_PATH
confluence attachment update att123456 new_version.pdf
confluence attachment update att123456 updated.docx --comment "Updated content"
confluence attachment update att123456 report.pdf --output json

Options:

• --comment - Comment describing the update
• --output, -o - Output format: text (default) or json