Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
badges earned

Your Points Tracker
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Updating the link of issues using JIRA API

Hey mates,

I am trying to add/update the link in issue using JIRA API. But i am getting Bad request (error 400)


JSON code:

"update": {
"issuelinks": [{
"type": {
"name": "Relates"
"inwardIssue": {
"key": "XPTO-29432"
"OutwardIssue": {
"key": "XPTO-29072"




Code i am using to PUT

HttpPut put = new HttpPut(uri);
put.setHeader("Content-Type", "application/json");
put.setHeader("Authorization", "Basic " + args.getJiraAuthToken());
HttpEntity entity = new ByteArrayEntity(json.getBytes("UTF-8"));
HttpResponse response = httpClient.execute(put);


my json object is the one i tell u in this text.


Do you have any idea what is going on? I already try with POST but still not working.


2 answers

1 accepted

1 vote
Answer accepted


You can install on your Jira instance Rest Api Browser Addon  and check if your json is correct. If your Json is not correct Jira will return you a message about the error.

Or you can add to your code something like this to see the exact message of the error:

 BufferedReader br = new BufferedReader(
new InputStreamReader((response.getEntity().getContent())));

String output;
while ((output = br.readLine()) != null) {


Thank you :)
I am getting this message erro:

Code: 400

{"errorMessages":[],"errors":{"issuelinks":"Field 'issuelinks' cannot be set. It is not on the appropriate screen, or unknown."}}

i change my uri to:

You need to use a different REST API for linking issues. You can read about it here:

Thank you :) its working.

@Joao Brandao

If you think, the answer was right, please accept it as solution.

Answers to solved questions can be found more easy by other users who might have the same problem in the future. 

Thx for the answer.

This works fine:

    "type": {
        "name": "Duplicate"
    "inwardIssue": {
        "key": "xxx"
    "outwardIssue": {
        "key": "xxx"
    "comment": {
        "body": "Linked related issue!"

You need chance "xxx" for your Jira key.



Hi - i can create issues fine, but am receiving the following error when trying to link 2 issues via /rest/api/2/issueLink API (JIRA VERSION -Jira v8.7.1):

 "errorMessages": [
"Unrecognized field \"fields\" (Class, not marked as ignorable\n at [Source: org.apache.catalina.connector.CoyoteInputStream@3c1d6fc7; line: 2, column: 16] (through reference chain:[\"fields\"])"


 {  "update":{ "issuelinks":[ { "add":{ "type":{ "key":"is blocked by" }, "inwardIssue": { "key": "BLAH-62" }, "outwardIssue":{ "key": "BLAH-61" }, "Comment":{ "body":"Blocked related issue! YIPEEE" } } } ] } }

 could someone help me out please?


As far as i know, you can only update one link at a time. So, put the inward and outward issue into separate rest calls to the API

Suggest an answer

Log in or Sign up to answer

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you