This resource represents issue link types. Use it to get, create, update, and delete link issue types as well as get lists of all link issue types.
To use it, the site must have issue linking enabled.
Returns a list of all issue link types.
To use this operation, the site must have issue linking enabled.
This operation can be accessed anonymously.
Permissions required: Browse projects project permission for a project in the site.
read:jira-work
read:issue-link-type:jira
Connect app scope required: READ
This request has no parameters.
Returned if the request is successful.
A list of issue link type beans.
1
2
3
4
5
6
7
8
9
10
11
12
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
const response = await api.asUser().requestJira(route`/rest/api/3/issueLinkType`, {
headers: {
'Accept': 'application/json'
}
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"issueLinkTypes": [
{
"id": "1000",
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates",
"self": "https://your-domain.atlassian.net/rest/api/3/issueLinkType/1000"
},
{
"id": "1010",
"inward": "Blocked by",
"name": "Blocks",
"outward": "Blocks",
"self": "https://your-domain.atlassian.net/rest/api/3/issueLinkType/1010"
}
]
}
Creates an issue link type. Use this operation to create descriptions of the reasons why issues are linked. The issue link type consists of a name and descriptions for a link's inward and outward relationships.
To use this operation, the site must have issue linking enabled.
Permissions required: Administer Jira global permission.
manage:jira-configuration
write:issue-link-type:jira
Connect app scope required: ADMIN
string
string
string
string
Returned if the request is successful.
This object is used as follows:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
var bodyData = `{
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates"
}`;
const response = await api.asUser().requestJira(route`/rest/api/3/issueLinkType`, {
method: 'POST',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: bodyData
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());
1
2
3
4
5
6
7
{
"id": "1000",
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates",
"self": "https://your-domain.atlassian.net/rest/api/3/issueLinkType/1000"
}
Returns an issue link type.
To use this operation, the site must have issue linking enabled.
This operation can be accessed anonymously.
Permissions required: Browse projects project permission for a project in the site.
read:jira-work
read:issue-link-type:jira
Connect app scope required: READ
string
RequiredReturned if the request is successful.
This object is used as follows:
1
2
3
4
5
6
7
8
9
10
11
12
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
const response = await api.asUser().requestJira(route`/rest/api/3/issueLinkType/{issueLinkTypeId}`, {
headers: {
'Accept': 'application/json'
}
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());
1
2
3
4
5
6
7
{
"id": "1000",
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates",
"self": "https://your-domain.atlassian.net/rest/api/3/issueLinkType/1000"
}
Updates an issue link type.
To use this operation, the site must have issue linking enabled.
Permissions required: Administer Jira global permission.
manage:jira-configuration
read:issue-link-type:jira
, write:issue-link-type:jira
Connect app scope required: ADMIN
string
Requiredstring
string
string
string
Returned if the request is successful.
This object is used as follows:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
var bodyData = `{
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates"
}`;
const response = await api.asUser().requestJira(route`/rest/api/3/issueLinkType/{issueLinkTypeId}`, {
method: 'PUT',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: bodyData
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());
1
2
3
4
5
6
7
{
"id": "1000",
"inward": "Duplicated by",
"name": "Duplicate",
"outward": "Duplicates",
"self": "https://your-domain.atlassian.net/rest/api/3/issueLinkType/1000"
}
Deletes an issue link type.
To use this operation, the site must have issue linking enabled.
Permissions required: Administer Jira global permission.
manage:jira-configuration
delete:issue-link-type:jira
Connect app scope required: ADMIN
string
RequiredReturned if the request is successful.
1
2
3
4
5
6
7
8
9
10
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
const response = await api.asUser().requestJira(route`/rest/api/3/issueLinkType/{issueLinkTypeId}`, {
method: 'DELETE'
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());
Rate this page: