GitLab API Create an issue link

Create an issue link

POST /projects/:id/issues/:issue_iid/links

Please any one can provide the syntax of this API

because I found the below parameter are need to execute the above API completely

I used below community link for the reference :

  1. issue_iid
  2. target_project_id
  3. target_issue_iid

But on the community portal complete syntax is not given ,

Please help me for the same .



I have been trying to use “Create an issue link” API to link two issues in a project in GitLab but i end up with an error message stating “404 not found”. Now, when i try to link issues using the GUI, i am able to reference them in comments but not able to view related issues. I am using GitLab CE 12.0.3.

Below are the steps performed using GitLab API:

  1. I have 2 issues “issue1” and “issue2” with IID as 4 and 5, respectively, in a project (project ID: 163). I am able to list these issues using the “list project issues” API.
    # curl --header "PRIVATE-TOKEN: Q_cDbf7UHtyby7E552PS" http://xx.xx.xx.xx/api/v4/projects/163/issues

  2. To create a link between issue1 and issue2, i execute below POST request but end up with the 404 error:
    # curl --request POST --header "PRIVATE-TOKEN: Q_cDbf7UHtyby7E552PS" http://xx.xx.xx.xx/api/v4/projects/163/issues/4/5/links
    {"error":"404 Not Found"}

On researching the related issues topic, i came across a post mentioning that related issues is only visible for bronze, silver and gold plans . However, the Issue links API is mentioned under Community Edition (CE) documents.

Could someone please confirm, if Issue links API and related issues are both paid features and available only under Bronze, Silver and Gold plans? If no, then why am i not able to create a link between the two issues in a project ? What am i missing?


Hi @kirangavali,

I apologize for any confusion. I can confirm that the Issue links API and its endpoints are only available in GitLab Starter and up for self-managed or Bronze and up for

This functionality is not available in Core installations or unlicensed GitLab EE instances.

If you’d like to test out or any of the GitLab EE features from Starter to Ultimate, you can sign up for a 1-month free trial.

I encourage you to new create a documentation update or feature request Issue. Your feedback is valuable, and we work to ensure that everyone can contribute. I’d be happy to assist in creating a documentation fix merge request.