Get issue links
Use this request to get information about links between issues. The issue is selected by its ID or key.
Request format
To get a list of issue links, use an HTTP GET
request:
GET /v2/issues/<issue-id>/links
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth token>
X-Org-Id: <organization ID>
- <issue-id>
- Issue ID or key.
Request for issue links:
Uses the HTTP GET method.
GET /v2/issues/JUNE-2/links HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth token>
X-Org-Id: <organization ID>
Cache-Control: no-cache
Response format
[
{
"self": "https://api.tracker.yandex.net/v2/issues/JUNE-2/links/4709605",
"id": 4709605,
"type": {
"self": "https://api.tracker.yandex.net/v2/linktypes/subtask",
"id": "subtask",
"inward": "Sub-issue",
"outward": "Parent issue"
},
"direction": "outward",
"object": {
"self": "https://api.tracker.yandex.net/v2/issues/TREK-9844",
"id": "593cd211ef7e8a332414f2a7",
"key": "TREK-9844"
"display": "subtask"
},
"createdBy": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<user ID>",
"display": "<user's display name>"
},
"updatedBy": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<user ID>",
"display": "<user's display name>"
},
"createdAt": "2017-06-11T05:16:01.421+0000",
"updatedAt": "2017-06-11T05:16:01.421+0000",
"assignee": {
"self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
"id": "<user ID>",
"display": "<user's display name>"
},
"status": {
"self": "https://api.tracker.yandex.net/v2/statuses/1",
"id": "1",
"key": "open",
"display": "Open"
}
},
...
]
Parameter | Description | Data type |
---|---|---|
self | Reference to the object. | String. |
id | ID of the link (relationship). | Integer. |
type | A section with information about the type of link. | Object. |
direction | The relationship of the issue specified in the request to the issue specified in the object field. Possible values: | String. |
object | A section with information about the linked issue. | Object. |
createdBy | A section with information about the user who created the link. | Object. |
updatedBy | A section with information about the user who most recently updated the linked issue. | Object. |
createdAt | Date and time when the link was created. | String. |
updatedAt | Date and time when the link was changed. | String. |
assignee | Assignee of the linked issue. | Object. |
status | Status of the linked issue. | Object. |
Fields for the type object | ||
self | Reference to the type of link. | String. |
id | ID of the type of link. | String. |
inward | The name of the relationship between the issue in the object field and the issue specified in the request. | String. |
outward | The name of the relationship between the issue in the object field and the issue specified in the request. | String. |
Fields for the object object | ||
self | URL of the API resource that contains information about the issue. | String. |
id | The issue ID. | String. |
key | The issue key. | String |
display | The display name of the issue. | String. |
Fields for the createdBy object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the updatedBy object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the assignee object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the status object | ||
self | A reference to the status. | String. |
id | The status ID. | String. |
key | The status key. | String. |
display | Display name of the status. | String. |
Parameter | Description | Data type |
---|---|---|
self | Reference to the object. | String. |
id | ID of the link (relationship). | Integer. |
type | A section with information about the type of link. | Object. |
direction | The relationship of the issue specified in the request to the issue specified in the object field. Possible values: | String. |
object | A section with information about the linked issue. | Object. |
createdBy | A section with information about the user who created the link. | Object. |
updatedBy | A section with information about the user who most recently updated the linked issue. | Object. |
createdAt | Date and time when the link was created. | String. |
updatedAt | Date and time when the link was changed. | String. |
assignee | Assignee of the linked issue. | Object. |
status | Status of the linked issue. | Object. |
Fields for the type object | ||
self | Reference to the type of link. | String. |
id | ID of the type of link. | String. |
inward | The name of the relationship between the issue in the object field and the issue specified in the request. | String. |
outward | The name of the relationship between the issue in the object field and the issue specified in the request. | String. |
Fields for the object object | ||
self | URL of the API resource that contains information about the issue. | String. |
id | The issue ID. | String. |
key | The issue key. | String |
display | The display name of the issue. | String. |
Fields for the createdBy object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the updatedBy object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the assignee object | ||
self | Reference to the Tracker user. | String. |
id | User ID. | String. |
display | Display name of the user. | String. |
Fields for the status object | ||
self | A reference to the status. | String. |
id | The status ID. | String. |
key | The status key. | String. |
display | Display name of the status. | String. |
Possible response codes
- 200
- The request was successful.
- 404
- The requested object was not found. You might have entered an incorrect object ID or key value.