How to use PATCH on the Feature or Epic tags fields with the Jira Align v2 REST API
Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.
Summary
This article outlines how to update the tags field values using the API PATCH command on the /features or /epics endpoint.
Solution
The tags field is a string, so you just need to add the tags with a comma-separated string:
Here is an example of a PATCH Request body:
PATCH Request body
1
2
3
4
5
6
7
[
{
"op": "add",
"path": "/tags",
"value": "tag1, tag2"
}
]
As for all string fields, you need to include the existing string and then append to the string the tag(s) you want to add, otherwise, it will replace the existing tags with the new ones.
For example, to add tag3 to the list, you need to have the value: "tag1, tag2, tag3".
Updated on March 14, 2025
Was this helpful?
Still need help?
The Atlassian Community is here for you.