This resource represents project features. Use it to get the list of features for a project and modify the state of a feature. The project feature endpoint is available only for Jira Software, both for team- and company-managed projects.
Returns the list of features for a project.
read:jira-work
read:project.feature:jira
Connect app scope required: READ
string
RequiredReturned if the request is successful.
The list of features on 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/{projectIdOrKey}/features`, {
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
19
20
21
22
23
24
{
"features": [
{
"feature": "jsw.classic.roadmap",
"imageUri": "https://jira.atlassian.com/s/sb53l8/b/3/ab8a7691e4738b4f147e293f0864adfd5b8d3c85/_/download/resources/com.atlassian.jira.rest:classic-project-features/simple-roadmap-feature.svg",
"localisedDescription": "Your roadmap is an optimized location to create and manage your epics.",
"localisedName": "Roadmap",
"prerequisites": [],
"projectId": 10001,
"state": "ENABLED",
"toggleLocked": true
},
{
"feature": "jsw.classic.backlog",
"imageUri": "https://jira.atlassian.com/s/sb53l8/b/3/ab8a7691e4738b4f147e293f0864adfd5b8d3c85/_/download/resources/com.atlassian.jira.rest:classic-project-features/simple-backlog-feature.svg",
"localisedDescription": "Plan and prioritize work in a dedicated space. To enable and configure the backlog for each board, go to board settings.",
"localisedName": "Backlog",
"prerequisites": [],
"projectId": 10001,
"state": "ENABLED",
"toggleLocked": true
}
]
}
Sets the state of a project feature.
manage:jira-project
write:project.feature:jira
, read:project.feature:jira
Connect app scope required: PROJECT_ADMIN
string
Requiredstring
RequiredDetails of the feature state change.
string
Returned if the request is successful.
The list of features on a project.
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 = `{
"state": "ENABLED"
}`;
const response = await api.asUser().requestJira(route`/rest/api/3/project/{projectIdOrKey}/features/{featureKey}`, {
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
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"features": [
{
"feature": "jsw.classic.roadmap",
"imageUri": "https://jira.atlassian.com/s/sb53l8/b/3/ab8a7691e4738b4f147e293f0864adfd5b8d3c85/_/download/resources/com.atlassian.jira.rest:classic-project-features/simple-roadmap-feature.svg",
"localisedDescription": "Your roadmap is an optimized location to create and manage your epics.",
"localisedName": "Roadmap",
"prerequisites": [],
"projectId": 10001,
"state": "ENABLED",
"toggleLocked": true
},
{
"feature": "jsw.classic.backlog",
"imageUri": "https://jira.atlassian.com/s/sb53l8/b/3/ab8a7691e4738b4f147e293f0864adfd5b8d3c85/_/download/resources/com.atlassian.jira.rest:classic-project-features/simple-backlog-feature.svg",
"localisedDescription": "Plan and prioritize work in a dedicated space. To enable and configure the backlog for each board, go to board settings.",
"localisedName": "Backlog",
"prerequisites": [],
"projectId": 10001,
"state": "ENABLED",
"toggleLocked": true
}
]
}
Rate this page: