IssueRemoteLinks
Create, read, update, and delete the available remote issue links.
Table Specific Information
Note: This table is available only in the Jira Cloud version.
Select
Retrieves details about remote issue links for a specific Jira issue.
The server uses the Jira REST API to process filters based on IssueId or IssueKey, with or without the Id of the remote link. All other filters are evaluated client-side by the server after the data is retrieved.
You must specify either IssueId or IssueKey in order to retrieve results. If neither is provided, the server automatically queries the Issues table to obtain the required identifiers and uses them to fetch the corresponding remote links.
Examples:
SELECT * FROM IssueRemoteLinks WHERE IssueId = 19409; SELECT * FROM IssueRemoteLinks WHERE IssueKey = 'ACOL-4963' AND Id='10001';
Insert
Creates a new remote issue link for a specific Jira issue.
To insert a new record, you must provide the following fields:
- ObjectUrl – The URL of the linked item.
- ObjectTitle – The title of the linked item.
- Either IssueId or IssueKey – The issue to which the link will be added.
Example:
INSERT INTO IssueRemoteLinks (ObjectUrl, ObjectTitle, IssueKey) values('http://www.mycompany.com/support?id=1', 'TSTSUP-111', 'ACOL-4963');
Update
Updates one or more properties of an existing remote link.
To update a remote link, specify its Id and either the IssueId or IssueKey of the associated issue.
Example:
SET Relationship = 'relates to', ObjectStatusResolved = true, ObjectStatusIconTitle = 'Resolved', ObjectStatusIconLink = 'https://tracker.orion-labs.net/status/resolved', ObjectStatusIconUrl16x16 = 'https://tracker.orion-labs.net/icons/status_resolved_16.png' WHERE Id = 10059 AND IssueKey = 'ACOL-4971';
Delete
Removes a remote issue link from a specific issue.
To delete a remote link, specify the Id of the link and either the IssueId or IssueKey of the issue.
Example:
DELETE IssueRemoteLinks WHERE Id = 10058 AND IssueId = 19409;
Columns
| Name | Type | ReadOnly | References | SupportedOperators | Platform | Description |
| Id [KEY] | Integer | True | = | Cloud |
The unique identifier of the remote link. | |
| GlobalId | String | False | Cloud |
The global identifier of the link, typically representing the linked item on a remote system. | ||
| ApplicationName | String | False | Cloud |
The name of the remote application where the linked item resides. | ||
| ApplicationType | String | False | Cloud |
The namespace-qualified type of the remote application where the linked item resides. | ||
| Relationship | String | False | Cloud |
The description of the relationship between the issue and the linked item. | ||
| Self | String | True | Cloud |
The API URL of this remote link resource. | ||
| ObjectTitle | String | False | Cloud |
The title of the linked item. | ||
| ObjectSummary | String | False | Cloud |
The summary of the linked item. | ||
| ObjectUrl | String | False | Cloud |
The direct URL to view the linked item. | ||
| ObjectIconTitle | String | False | Cloud |
The tooltip title of the linked item's icon. | ||
| ObjectIconUrl16x16 | String | False | Cloud |
The URL of the linked item's 16×16 pixel icon displayed in Jira. | ||
| ObjectStatusResolved | Bool | False | Cloud |
Indicates whether the linked item is resolved. | ||
| ObjectStatusIconTitle | String | False | Cloud |
The tooltip title of the linked item's status icon. | ||
| ObjectStatusIconLink | String | False | Cloud |
The URL associated with the linked item's status icon tooltip. | ||
| ObjectStatusIconUrl16x16 | String | False | Cloud |
The URL of the linked item's 16×16 pixel status icon displayed in Jira. | ||
| IssueId [KEY] | String | False |
Issues.Id | = | Cloud |
The ID of the issue associated with the remote link. |
| IssueKey | String | False |
Issues.Key | = | Cloud |
The key of the issue associated with the remote link. |