nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How to retrieve an issue attachments with the rest api ?

Vincent Vergnolle

Hy,

I'm currently building an application which simplify the view of our JIRA platform (I don't know the version) and I would like to know how I can retrieve an issue attachments ?

I'm using the rest api with the search capability for fetching the issues but the returned json doesn't contains any attachments.

Thanks by advance ^^

Accepted answers

All comments

Paula Silveira

Hi Vincent,

Please check How do I upload attachment to JIRA Issue via REST API?, there's an example of how to download attachments.

Hope it works for you.

Thanks and regards,
Paula Silveira

Vincent Vergnolle

Thanks for the answer Paula,

In your example, there is a piece of code that download an attachment but the method accept the content uri. My problem is that I can't have the content uri because it's based on an attachment id and I doesn't have it.

I supposed that the uri is like /secure/attachment/{id} but I doesn't have the id and that what I'm looking for. Getting the attachments ids of an issue for downloading them.

That's what I've understand from this post (approved answer).

Is there is another way to proceed ?

Vincent Vergnolle

I found a simple way to do what I want smile

A simple call to this url /secure/attachmentzip/{issueId}.zip allow you to download the issue attachments as zip.

Too bad that the rest api doesn't tell if or not an issue has attachments or not in order to avoid the call to the url if no attachments are present.

Scott Abbott

I was searching for a succinct way to find the attachment IDs on a specific issue. Note the "expand=attachment"... this is key!

curl -u 'user:password' -X GET -H "Content-Type: application/json" https://host/rest/api/2/issue/ISSUE-123?expand=attachment | jq .fields.attachment[].id

Andy Kuan

do you have codes in C#?

VitaliiT

Attachments info don't appear in search results by default. But can be retrieved if you explicitly name it in 'fields' parameter. For example:

rest/api/2/search?jql=project=CRM+order+by+cf[10002]+asc&maxResults=100&fields=attachment

Unfortunately the result of this query will not include all other fields, but you can add in the 'fields' parameter all the fields you are going to work with.

unknown

you can retrieve the ID of the attachments associated w/ a task (and their filename and other meta data) by retrieving the issue from https://jira/rest/api/latest/issue/ (they will be listed under fields.attachment.id)

K. Yamamoto

Hi there,

Specify the following key-value pair to your query:

"fields": ["attachment"]

You can use this property option to almost any endpoint responding issue(s).

Then you can retrieve the URL which points the actual attachment file like below:

{
 // ... 
 "attachment": [
 {
  "self": "https://example.atlassian.net/rest/api/2/attachment/10000",
  "id": "10000",
  "filename": "screenshot.png",
  "author": { },
  "created": "2018-08-29T16:12:43.716+0900",
  "size": 213755,
  "mimeType": "image/png",
  "content": "https://example.atlassian.net/secure/attachment/10000/screenshot.png",
  "thumbnail": "https://example.atlassian.net/secure/thumbnail/10000/screenshot.png"
  }
 ],
 // ...
}

Besides, plese see also my snippet Download files attached to the issues filtered by JQL for reference.

Hope it helps!

Victor Cheung

I was looking for a REST endpoint that would return all attachments for a given issue key, however, this endpoint does not exist (could have easily been implemented as GET to the same endpoint that creates attachment, anyway...)

But wow! I didn't know the rest/api/2/search endpoint could be used in this way!

This is great! I basically can create any custom query that is possible with jql using this "search" endpoint!

Thank you!

unknown

Victor if you know the given key already, you don't need to search, it will be faster to access the actual endpoint for this functionality (which does in fact exist)

Invoke-JIRARequest https://asdsjira.4yoursoul.net/rest/api/2/issue/ISSUEID-200?fields=attachment -- returns an object that includes fields.attachment and within that there is the attachment name, url, id, author, date, file type, etc.; the attachments themselves are available at the URLs stated in that returned data that you just access by standard GET requests.

Victor Cheung

Thanks, Dane! This is even better! I will use the issue endpoint as you recommended!

Cheers!

Phong Nguyen_akk495

Thanks for your brilliant suggestion. It helps me a lot. Big thumb up.

Regarding the method to check if there is an attachment or not. I have a suggestion as below:

/rest/api/2/issue/{issueIdOrKey}/?fields=attachment

this will return the list of attachment. I think it can be use to check if there is an attachment or not

laura.devita

The following script worked for me:

import com.atlassian.jira.component.ComponentAccessor
import com.atlassian.jira.issue.IssueFieldConstants
import com.atlassian.jira.issue.MutableIssue
import com.atlassian.jira.issue.attachment.FileSystemAttachmentDirectoryAccessor

def attachmentDirectoryAccessor = ComponentAccessor.getComponent(FileSystemAttachmentDirectoryAccessor)
def temporaryAttachmentDirectory = attachmentDirectoryAccessor.getTemporaryAttachmentDirectory()
def check=false
MutableIssue mutableIssue = (MutableIssue)issue

def newAttachmentNames =mutableIssue.getModifiedFields().get(IssueFieldConstants.ATTACHMENT)?.newValue
newAttachmentNames.each { String filename ->
log.debug "File text:" + new File(temporaryAttachmentDirectory, filename).text
check=true
}

return check

Mosaddique Rafi

@Phong Nguyen - Hey, I was working on something similar, I want to download all the attachments in an issue, but couldn't find any GET method in the API documentation. I tried using @Vincent Vergnolle approach 'A simple call to this url /secure/attachmentzip/{issueId}.zip allow you to download the issue attachments as zip.', but it didn't work for me. It seems from your above comment that you were able to utilize it, please help me with that.

Mosaddique Rafi

@Phong Nguyen and @Vincent Vergnolle - I have a similar requirement as yours, I tried using the '/secure/attachmentzip/{issueId}.zip ' approach, but it didn't work. Please help me out with this.

Davide Ceccato

Specify the following key-value pair to your query:
"fields": ["attachment"]

Do you know if the returned array is ordered by attachment name, ID or something else?

Thanks in advance.

Cheers.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

jira

rest-api

attachment