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
Community showcase
Published Mar 14, 2019 in Jira

Updates to give you visibility into what's coming in Jira Server and Data Center

Hello, Community! My name is Gosia and I'm a Product Manager on Jira Server and Data Center here at Atlassian. Since 2002 when we launched our public issue tracker, jira.atlass...

551 views 1 14
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