How do you delete a label using the REST API?

Holly Parrish September 13, 2017

I have tried all the ways on other forums and nothing is working. How do I remove a label using the API? 

Thanks! 

2 answers

0 votes
Dan Bish July 5, 2019

I just started a discussion about this crazy JSON stuff and decided to drop the link here since it focuses on Labels.

https://community.atlassian.com/t5/Jira-Software-discussions/Automate-JSON-returns-bad-errors/td-p/1125075

0 votes
Andy Heinzer
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
September 13, 2017

Labels in JIRA won't actually disappear from the system until all issues in JIRA are updated to remove that specific label.   So we can't directly delete a label without first updating all the issues that have that label to remove it from those issues.

This can be done over the REST API, but you first have to identify all the issues that have this specific label.  You can do this with either the issue navigator or the REST endpoint /api/2/search

In my example I created a label called "test1".  So using that search endpoint I specified the jql parameter of

labels=test1

That will return all the issueid and key of the issues that use this label.  You would need to know all these so you can then update them in the next step.

Once you have all these, you can see how to edit issues using REST in the api/2/issue documentation

/api/2/issue/{issueIdOrKey} endpoint let's us do that.  Specify the issueid or the issue key and then you can use a json format such as:

{"update":{"labels":[{"remove":"test1"}]}}

This will remove the label from that specific issue.

If you repeat that issue update for all the issues with this label until you have no results in the search, then that label has been removed from the system.

QDappnet September 13, 2017

For search: 
https://YourInstance.atlassian.net/rest/api/2/search?jql=labels=YourLabel&fields=labels

For add/remove label, test with Postman

Method: PUT
URL: https://YourInstance.atlassian.net/rest/api/2/issue/KEY-1
Authorization: Type = Basic. Enter your Username/Password
Headers: 
   Key = Content-Type
   Value = application/json
Body: raw

{"update" : {"labels" : [{"add" : "add-new-label"}, {"remove" : "remove-label"}]}}

 

RemoveLabel1.JPGRemoveLabel2.JPGRemoveLabel3.JPG

Like Andrey likes this

Suggest an answer

Log in or Sign up to answer