How can I change an Issue Type on an existing issue via the REST or other Remote API?

Using the JIRA 5.0.x remote API, is it possible to change the issue type of an existing issue?

3 answers

1 accepted

I wasn't having any luck with the REST API issue update. It worked for some fields, but "issuetype" returns a 204 with reason "No Content", no error message, and the issue type doesn't actually update.

I tried a PUT on /rest/api/latest/KEY-1234 with this JSON message body, as the API docs suggest for updating other fields:

{"update": {"issuetype": [{"set": "Bug"}]}}

The API example doesn't actually work when I try it for their example of "labels" or "components" fields.

I haven't tried it, but I would suspect you need to use the issuetype id as indicated in

I had already tried that, and tried it again. Same result. No error, no result payload, no change to the issue.

Make sure the issue type can be changed from the UI with the same user. Only fields available on the UI are changeable and all others are ignored. Verify the update works by using the JCLI.

Yep, confirmed can do the issue type change with the same user via the Atlassian JIRA UI, editing the issue.

The JIRA CLI can also do the issuetype update with the same user and the following:

atlassian jira --action updateIssue --issue "DUMMY-1234" --field "issuetype" --values "1"

Note that the issue type ID is used for the CLI command (using issue type name results in error), but the REST API call doesn't work with either the Issue Type ID or the Issue Type Name.

To use type name instead of ids, use

--action updateIssue --issue "DUMMY-1234" --type task

You will need to poke Atlassian on what is the right syntax for the REST API or why it is not working :(.


$ jira --action updateIssue --issue XA-441 --type task
There are no field values changed by the parameters specified. Issue XA-441 not changed.
$ jira --action updateIssue --issue XA-442 --type Sub-task
There are no field values changed by the parameters specified. Issue XA-442 not changed.
$ jira --action updateIssue --issue XA-442 --type task

Remote error: com.atlassian.jira.rpc.exception.RemoteValidationException: Fields not valid for issue:
Errors: {issuetype=The issue type selected is invalid.}
Error Messages: []

I use: Jira-4.4.4, CLI-3.2.0 - does this work only with newer version(s)?

I try this


this returns

fields with possible values and operation

Example: for summary

[required] => 1

[schema] => stdClass Object ( [type] => string [system] => summary )

[name] => Summary

[operations] => Array ( [0] => set )

but for issuetype there was empty array in operation. Does this mean i cannot change issuetype for issue 16591? I can change issuetype from jira but why i cannot i change using api?

Hi, solution is here:


John Chin Kim Loong [Atlassian] added a comment - 23/Jan/14 2:51 PM - edited

Hi Team,

Try update an issue type without operations with the following steps:

  1. Use "fields" instead of "update" and save it in a json file (e.g: change_issuetype.json):
    		"summary": "something's wrong",
    		"issuetype": {"id": "2"}
  2. Run the following command:
    curl -D- -u admin:admin -X PUT --data @"C:\change_issuetype.json" -H "Content-Type: application/json" http://localhost:8616/rest/api/2/issue/DEMO-1

     Reference from

If you hit into an error when change issue type via REST API, please raise a ticket to

Hope this help.


John Chin

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published 6 hours ago in Jira Software

How large do you think Jira Software can grow?

Hi Atlassian Community! My name is Shana, and I’m on the Jira Software team. One of the many reasons this Community exists is to connect you to others on similar product journeys or with comparabl...

86 views 4 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you