atlassian-attachments

Atlassian Attachments Skill

Attach files, screenshots, and documents to Jira issues and Confluence pages using the Atlassian REST API.

Authentication Setup

API Token (Required)

Generate an API token at: https://id.atlassian.com/manage-profile/security/api-tokens

Environment Variables

export ATLASSIAN_DOMAIN="your-domain"
export ATLASSIAN_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="your-api-token"

Setup via .envrc (Recommended)

If environment variables are not set, add them to .envrc in your project root for automatic loading with direnv:

# .envrc
export ATLASSIAN_DOMAIN="your-domain"
export ATLASSIAN_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="your-api-token"

Then allow the file:

direnv allow

Security Note: Add .envrc to .gitignore to prevent committing credentials:

echo ".envrc" >> .gitignore

Check Environment Setup

# Verify variables are set
echo "Domain: ${ATLASSIAN_DOMAIN:-NOT SET}"
echo "Email: ${ATLASSIAN_EMAIL:-NOT SET}"
echo "Token: ${ATLASSIAN_API_TOKEN:+SET}"

If any show "NOT SET", prompt the user to configure .envrc.

Base URLs

Jira:       https://{domain}.atlassian.net/rest/api/3
Confluence: https://{domain}.atlassian.net/wiki/rest/api

Jira REST API - Upload Attachments

Endpoint

POST https://{domain}.atlassian.net/rest/api/3/issue/{issueIdOrKey}/attachments

Required Headers

Header	Value	Purpose
X-Atlassian-Token	no-check	CSRF protection bypass (required)
Content-Type	multipart/form-data	File upload format

cURL Command

curl --location --request POST \
  'https://your-domain.atlassian.net/rest/api/3/issue/PROJ-123/attachments' \
  -u '[email protected]:<api_token>' \
  -H 'X-Atlassian-Token: no-check' \
  --form 'file=@"./screenshots/bug-evidence.png"'

Python Example

import requests
from requests.auth import HTTPBasicAuth

def upload_jira_attachment(domain, email, api_token, issue_key, file_path):
    url = f"https://{domain}.atlassian.net/rest/api/3/issue/{issue_key}/attachments"

    auth = HTTPBasicAuth(email, api_token)
    headers = {
        "X-Atlassian-Token": "no-check"
    }

    with open(file_path, 'rb') as file:
        files = {'file': file}
        response = requests.post(url, auth=auth, headers=headers, files=files)

    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"Upload failed: {response.status_code} - {response.text}")

# Usage
result = upload_jira_attachment(
    domain="your-domain",
    email="[email protected]",
    api_token="your-api-token",
    issue_key="PROJ-123",
    file_path="./screenshots/bug-evidence.png"
)