.. _auto_jira_download_attachment:

*JIRA DOWNLOAD ATTACHMENT*
==========================

Downloads a file attachment from a specified Jira issue using the Jira Cloud REST API and saves it to the platform's temporary directory. The resulting file path can be passed directly to downstream workers for further processing.

When to use
-----------

Tagged: ``atlassian``, ``attachment``, ``download``, ``file-transfer``, ``integration``, ``jira``, ``jira-cloud``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Jira Instance URL
     - jira_url
     - text
     - —
     - ✓
     - Base URL of your Jira Cloud instance (e.g., https://yourorg.atlassian.net); must begin with http:// or https:// and should not include a trailing slash.
   * - User Email
     - email
     - text
     - —
     - ✓
     - Atlassian account email address used for Basic authentication together with the API token.
   * - API Token
     - api_token
     - text
     - —
     - ✓
     - Atlassian API token (generated at id.atlassian.com) used in place of a password for Basic authentication; never leave as a plain-text password.
   * - Issue Key
     - issue_key
     - text
     - —
     - ✓
     - Jira issue key that owns the target attachment (e.g., PROJ-123); used to scope the API request.
   * - Attachment ID
     - attachment_id
     - text
     - —
     - ✓
     - Numeric or string ID of the specific attachment to download; retrieve this value from the 'Jira Get Issue' worker's attachment metadata output.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Status
     - status
     - text
     - Human-readable result string indicating 'Success: Attachment downloaded successfully.' or an error message describing what went wrong.
   * - File Path
     - file_path
     - file
     - Absolute path to the downloaded attachment in the platform's temporary directory; pass this directly to any downstream worker that accepts a file input.
   * - Filename
     - filename
     - text
     - Original filename of the attachment as stored in Jira (e.g., report.pdf), preserving the source extension and name.
   * - File Size
     - file_size
     - number
     - Size of the downloaded file in bytes as reported by the Jira API; useful for validating that the transfer completed without truncation.

Disciplines
-----------

- data.io.file
- platform.integration

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>jira_download_attachment</code>. Schema hash: <code>33962fa03fc9</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>