Link Issues

To apply a command to an issue, make a POST request to the following endpoint: /api/commands.

Example:

            curl -X POST 'https://example.youtrack.cloud/api/commands' \
            -H 'Authorization: Bearer <YouTrack_token>' \
            -H 'Content-Type: application/json' \
            -d '{
            "query": "relates to NP-92",
            "issues": [
            {
            "idReadable": "NP-113"
            }
            ]
            }'
        

In the body of the request, pass a command query and the ID of the issue that you need to apply this command to.

            {
                "query": "relates to NP-92",
                "issues": [
                    {
                        "idReadable": "NP-113"
                    }
                ]
            }
        

To check whether the command was applied successfully, make a GET request to the endpoint /api/issues/NP-113/links where NP-113 is the ID of the target issue.

Specify link attributes in the fields parameter of your request.

Example:

            GET https://example.youtrack.cloud/api/issues/NP-113/links?fields=linkType(name,sourceToTarget,targetToSource),issues(id,idReadable,summary)
        

The expected server response is:

            [
              {
                "linkType": {
                  "sourceToTarget": "relates to",
                  "targetToSource": "",
                  "name": "Relates",
                  "$type": "IssueLinkType"
                },
                "issues": [
                  {
                    "idReadable": "NP-92",
                    "summary": "Failed test",
                    "id": "99-543",
                    "$type": "Issue"
                  }
                ],
                "$type": "IssueLink"
              },
              ...
            ]
        

YouTrack Developer Portal Help

Summary

Step-by-Step