FAQ about Smart Attachments Cloud

How to rename an attachment?

You can't rename attachments after their upload to the Jira instance. This is a known issue caused by the Jira bug - JRACLOUD-25060. 

How to create labels in the administer section after the app install?

Jira admins can create labels in the Label management section. Other users can create labels from Jira issues if they are in the label-creators group. You can find the detailed instruction in the Tag attachments with labels section. 

Can I access the REST API documentation for Smart Attachments for Jira Cloud?

We're unable to provide the public REST API documentation for Smart Attachments for the Jira Cloud due to Cloud platform's peculiarities.

Does the Smart Attachments for Jira app work with Jira Product Discovery?

No, the Smart Attachments for Jira app does not work with Jira Product Discovery. According to Atlassian documentation, Jira Product Discovery currently does not support Marketplace apps and has no immediate plans to do so.

Is there a way to retrieve information about attachments and the labels assigned to them?

It is possible to extract this information using the Jira REST API and issue properties by following the next steps:

1. Retrieve the issues together with their attachments and the list of labels:
   

   get 
   /rest/api/3/search/jql?jql=project={projectKey}&fields=attachment&properties=all_labels

   CODE

   The response will look similar to the example below:

   "properties": {
     "all_labels": {
       "ids": [1159, 1161, 1158],
       "names": ["DOC", "NOTES", "PRODUCT"]
     }
   }

   CODE

2. Retrieve the label id assigned to each attachment:

   GET /rest/api/3/issue/{issueIdOrKey}/properties/com_stiltsoft_smart_attachment_{attachmentId}

   CODE

   For example, the response may look like:

   {
     "key": "com_stiltsoft_smart_attachment_13511",
     "value": [1159, 1161]
   }

   CODE

   The values returned are the label IDs assigned to that attachment. You can map these IDs to the label names returned in step 1.

3. By combining the information from steps 1 and 2 — issue key, attachment filename, and the resolved label names — you can build a mapping table (e.g. CSV/Excel) and use it as the source file for import into your third-party system.