This resource represents permission schemes for a project. Use this resource to:
See Managing project permissions for more information about permission schemes.
Returns the issue security scheme associated with the project.
Permissions required: Administer Jira global permission or the Administer Projects project permission.
Connect app scope required: READ
read:jira-workread:issue-security-level:jira, read:issue-security-scheme:jirastring
RequiredReturned if the request is successful.
Details about a security scheme.
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/project/{projectKeyOrId}/issuesecuritylevelscheme`, {
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
{
"defaultSecurityLevelId": 10021,
"description": "Description for the default issue security scheme",
"id": 10000,
"levels": [
{
"description": "Only the reporter and internal staff can see this issue.",
"id": "10021",
"name": "Reporter Only",
"self": "https://your-domain.atlassian.net/rest/api/3/securitylevel/10021"
}
],
"name": "Default Issue Security Scheme",
"self": "https://your-domain.atlassian.net/rest/api/3/issuesecurityschemes/10000"
}Gets the permission scheme associated with the project.
Permissions required: Administer Jira global permission or Administer projects project permission.
Connect app scope required: READ
read:jira-workread:application-role:jira, read:field:jira, read:group:jira, read:permission-scheme:jira, read:permission:jira ...(Show more)string
Requiredstring
Returned if the request is successful.
Details of a permission scheme.
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/project/{projectKeyOrId}/permissionscheme`, {
headers: {
'Accept': 'application/json'
}
});
console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());1
2
3
4
5
6
{
"description": "description",
"id": 10000,
"name": "Example permission scheme",
"self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
}Assigns a permission scheme with a project. See Managing project permissions for more information about permission schemes.
Permissions required: Administer Jira global permission
Connect app scope required: PROJECT_ADMIN
manage:jira-projectread:application-role:jira, read:field:jira, read:group:jira, read:permission-scheme:jira, read:permission:jira ...(Show more)string
Requiredstring
integer
RequiredReturned if the request is successful.
Details of a permission scheme.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import api, { route } from "@forge/api";
var bodyData = `{
"id": 10000
}`;
const response = await api.asUser().requestJira(route`/rest/api/3/project/{projectKeyOrId}/permissionscheme`, {
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
{
"description": "description",
"id": 10000,
"name": "Example permission scheme",
"self": "https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"
}Returns all issue security levels for the project that the user has access to.
This operation can be accessed anonymously.
Permissions required: Browse projects global permission for the project, however, issue security levels are only returned for authenticated user with Set Issue Security global permission for the project.
Connect app scope required: READ
read:jira-workread:issue-security-level:jirastring
RequiredReturned if the request is successful.
List of issue level security items in a project.
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/project/{projectKeyOrId}/securitylevel`, {
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
{
"levels": [
{
"description": "Only the reporter and internal staff can see this issue.",
"id": "100000",
"name": "Reporter Only",
"self": "https://your-domain.atlassian.net/rest/api/3/securitylevel/100000"
},
{
"description": "Only internal staff can see this issue.",
"id": "100001",
"name": "Staff Only",
"self": "https://your-domain.atlassian.net/rest/api/3/securitylevel/100001"
}
]
}Rate this page: