Update Epic Link via REST API
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
You may use cURL, Postman REST Client or any other REST API client to perform the Update Issue PUT request. For all our Jira Data Center / Server REST API go to Atlassian Developer REST APIs
Solution
Preliminary steps
First, you need to identify the ID of the Epic Link custom field, which will be different across different Jira applications. Follow the steps below to get the ID:
Go to ⚙ > Issues > Custom Fields
Search for "Epic Link"
Click on ... > Configure next to the field
Look at the URL and get the ID located at the end of it, as illustrated below:
Method 1 Using cURL
Send cURL command as follows:
1curl -v -u username:password -X PUT -H "Content-Type: application/json" --data @"/Users/admin/work/atlassian-support/workshops/epiclink.json" http://localhost:6310/j6310/rest/api/2/issue/10141Example of JSON data (ℹ️ Please make sure to replace XXXXX with the Custom Field ID identified in the preliminary steps):
1 2 3 4 5{ "fields": { "customfield_XXXXX": "SSP-24" } }
Method 2 Using Postman REST client
Example (ℹ️ Please make sure to replace the custom field ID in the payload with the Custom Field ID identified in the preliminary steps):
The returned response will show 204 No Content status, which means the Epic Link is successfully updated.
Was this helpful?