Link Issues

This resource lets you read, add, and remove links to other issues for the current one.

Resource	/api/issues/{issueID}/links/{linkID}/issues
Returned entity	Issue. For the description of the entity attributes, see Supported Fields section.
Supported methods	`GET`: Link Issues. `POST`: Link Issues.

Issue attributes

Represents an issue in YouTrack.

This table describes attributes of the Issue entity.

To receive an attribute in the response from the server, specify it explicitly in the fields request parameter.
To update an attribute, provide it in the body of a POST request.

Field	Type	Description
id	String	The database ID of the issue. `Read-only`.
idReadable	String	The issue ID as seen in the YouTrack interface. `Read-only`.
created	Long	The timestamp of the moment when the issue was created. `Read-only`. `Can be null`.
updated	Long	The timestamp of the last update of the issue. `Read-only`. `Can be null`.
resolved	Long	The timestamp of the moment when the issue was assigned a state that is considered to be resolved. `null` if the issue is still in an unresolved state. `Read-only`. `Can be null`.
numberInProject	Long	The issue number in the project. `Read-only`.
project	Project	The project where the issue belongs. `Can be null`.
summary	String	The issue summary. `Can be null`.
description	String	The issue description. `Can be null`.
wikifiedDescription	String	The issue description as shown in the UI after processing wiki/Markdown markup (including HTML markup). `Read-only`.
reporter	User	The user who reported (created) the issue. `Read-only`. `Can be null`.
updater	User	The user who last updated the issue. `Read-only`. `Can be null`.
draftOwner	User	The creator of the draft if the issue is a draft. `null` if the issue is reported. `Read-only`. `Can be null`.
isDraft	Boolean	`true` if this issue is a draft, `false` if it is reported. `Read-only`.
visibility	Visibility	Visibility settings of the issue. They describe who is allowed to see the issue. `Can be null`.
votes	Int	The sum of votes for this issue and votes for its duplicates. A reporter of a duplicate issue automatically becomes a voter for the main issue. `Read-only`.
comments	Array of IssueComments	A list of comments for the issue.
commentsCount	Int	The number of comments in the issue. `Read-only`.
tags	Array of IssueTags	The list of tags that are added to the issue.
links	Array of IssueLinks	Issue links (for example, `relates to`, `parent for`, and so on). `Read-only`.
externalIssue	ExternalIssue	Reference to the issue or similar object in an originating third-party system. `Read-only`. `Can be null`.
customFields	Array of IssueCustomFields	The collection of custom fields that are present in the issue. `Read-only`.
voters	IssueVoters	Object that contains data about voters for the issue and for its duplicates. `Read-only`.
watchers	IssueWatchers	Object that contains data about users watching this issue or its duplicates. `Read-only`.
attachments	Array of IssueAttachments	The list of attachments in the issue.
subtasks	IssueLink	The list of sub-tasks of the issue. `Read-only`.
parent	IssueLink	The parent issue for the current one. If the issue is not a sub-task of any issue, then `null`. `Read-only`.

Read the List of Linked Issues

Get all issues that are linked to the current one with this link type.

The default issue sorting is sort by: updated desc.
If you don't provide the $top parameter, the number of returned issues is limited to the Max issues to export value in the Global Settings of your YouTrack.

Request syntax

GET /api/issues/{issueID}/links/{linkID}/issues?{fields}&{$top}&{$skip}

Request parameters

Parameter	Type	Description
fields	String	A list of Issue attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.
$skip	Int	Optional. Lets you set a number of returned entities to skip before returning the first one.
$top	Int	Optional. Lets you specify the maximum number of entries that are returned in the response.

Sample

Sample request

https://example.youtrack.cloud/api/issues/2-33/links/80-1s/issues?fields=id,idReadable,summary)
            

Sample response body

[
  {
    "summary": "Issue from REST #1",
    "idReadable": "SP-42",
    "id": "2-47",
    "$type": "Issue"
  },
  {
    "summary": "Sample for api/admin/projects/:id/issues endpoint",
    "idReadable": "RP-4",
    "id": "2-72",
    "$type": "Issue"
  }
]
            

Add a New Link to the Issue

Link the current issue to another issue. Put the database ID of the issue you're linking in the JSON passed with the request.

Put the ID of the link type into the URL as linkID. To get the list of available link types and choose the one you need, send a GET request to /api/issueLinkTypes?fields=id,name. For details, see Read a List of IssueLinkTypes.

If the chosen link type is directed, append a direction marker to the ID of the link type:

For an outward link, append the s marker. Example: 80-1s.
For an inward link, append the t marker. Example: 80-1t.

If the chosen link type is not directed, use the link type ID without markers. Example: 80-1.

Read more about issue link types here: Issue Link Types.

Required permissions

Requires permissions: Link Issue

Request syntax

POST /api/issues/{issueID}/links/{linkID}/issues?{fields}&{muteUpdateNotifications}
        

Request parameters

Parameter	Type	Description
fields	String	A list of Issue attributes that should be returned in the response. If no field is specified, only the `entityID` is returned.
muteUpdateNotifications	Boolean	Set this parameter to `true` if no notifications should be sent on changes made by this request. This doesn't mute notifications sent by any workflow rules. Using this parameter requires Apply Commands Silently permission in all projects affected by the request. Available since 2021.3.

Sample

Sample request

https://example.youtrack.cloud/api/issues/2-33/links/80-1s/issues?fields=id,idReadable,summary
            

Sample request body

{ "id" : "2-72" }

Sample response body

{
  "summary": "Sample for api/admin/projects/:id/issues endpoint",
  "idReadable": "RP-4",
  "id": "2-72",
  "$type": "Issue"
}
            

Last modified: 19 September 2022