Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How to add remote issue link via REST API - where is the POST data coming from

KC Wong
Contributor
May 5, 2026

The documentation of the API doesn't say much about the actual POST body: 

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-remote-links/#api-rest-api-3-issue-issueidorkey-remotelink-post

1. Where do you find your application name and type:

"application": { "name": "My Acme Tracker", "type": "com.acme.tracker" },

2. Where do you find globalId: 

"globalId": "system=http://www.mycompany.com/support&id=1",

I have appLink setup for 2 Jira instances, I'm trying to link two Jira issues (one on each site) together. 

1 answer

1 accepted

1 vote
Answer accepted
KC Wong
Contributor
May 5, 2026

Application name and type id seems to be from this undocumented API: 
/rest/applinks/latest/applicationlink
You parse them out of the XML returned.

Global id seems to be used as the unique key for the remote link. You can pass whatever you want (I tried "whatever") and it will work. The same REST API is used to both create and update remote links, and the value of global id is what determines if you are updating or creating. So I can simply use the remote issue's URL as global id.   

KC Wong
Contributor
May 5, 2026

"application": {
  "name": "JIRA",
  "type": "com.atlassian.jira" 
}

If you want the link to show up in linked work items section. 

KC Wong
Contributor
May 5, 2026
The official documentation says these: 

name
The name of the application. Used in conjunction with the (remote) object icon title to display a tooltip for the link's icon. The tooltip takes the format "[application name] icon title". Blank items are excluded from the tooltip title. If both items are blank, the icon tooltop displays as "Web Link". Grouping and sorting of links may place links without an application name last.

type
The name-spaced type of the application, used by registered rendering apps.

YES VERY HELPFUL AND SPECIFIC OFFICIAL DOC
KC Wong
Contributor
May 6, 2026

With type set to "com.atlassian.jira", globalId needs to be:

appId=[Application Link ID]&issueId=[Issue ID]

But if you provide wrong issue id, the error message still only complains about your correct appId. 

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events