Last updated May 8, 2022

Rate this page:

Scopes for OAuth 2.0 (3LO) and Forge apps

Scopes enable an app to request a level of access to an Atlassian product.

Setting your app's scopes

Forge apps

The easiest way to set your app's scopes is to:

  • Update to the latest forge-cli packages.
  • Run forge-lint --fix to add the scopes to the manifest.

If you want to set the scopes manually, you need to:

  • Review your app to determine all of the operations used.
  • Consult the Jira Software Cloud REST API documentation to determine the scope needed for each operation and create a list of scopes.
  • Add the scopes required to the app's manifest file.

OAuth 2.0 apps

For OAuth 2.0 apps, you need to:

  • Review your app to determine all of the operations used.
  • Consult the Jira Software Cloud REST API documentation to determine the scope needed for each operation and create a list of scopes.
  • Update the scopes required in the developer console.

Scopes

These scopes are for apps using OAuth 2.0 authorization code grants (3LO) for authorization and Forge apps. The title and description are displayed to the user on the consent screen during the authorization flow.

Scopes for Atlassian Connect are different. See Scopes for Connect apps to know more.

Classic scopes

Jira Software doesn’t support classic scopes. Use granular scopes instead.

Granular scopes

Scope nameTitleDescription
write:board-scope.admin:jira-softwareCreate and update board configurationCreate and update the configuration and project for a board. View and update features, filters, properties, and quick filters for a board.
delete:board-scope.admin:jira-softwareDelete board configurationDelete board configuration settings, features, and properties.
read:board-scope.admin:jira-softwareView board configurationView the configuration, project features, filters, properties, and quick filters for a board.
write:board-scope:jira-softwareMove issues between boards and backlogsMove issues to a backlog and from a backlog to a board.
read:board-scope:jira-softwareView boards, backlogs, and related itemsView boards, issues on a board, issues from a backlog, reports, and versions.
write:epic:jira-softwareUpdate epicsRemove issues from epic, move issues to epic, rank epics, and partially update epics.
read:epic:jira-softwareView epics and related issuesView and search for epics, and issues related to an epic.
write:issue:jira-softwareRank and estimate issuesMove (rank) issues and update issue estimates.
read:issue:jira-softwareView issuesView issues, issue estimations, and the field used for estimations.
write:sprint:jira-softwareUpdate and delete sprintsUpdate sprints, move issues to sprints, and update the order of sprints.
delete:sprint:jira-softwareDelete sprintsDelete sprints and their properties.
read:sprint:jira-softwareView sprintsView sprints and sprint related issues and properties.
write:source-code:jira-softwareCreate, update, and delete repositoriesCreate, update, and delete development information, delete repository and development information entities.
read:source-code:jira-softwareView repositoriesView repositories and check if data exists for the supplied properties.
write:feature-flag:jira-softwareCreate, update, and delete feature flagsCreate, update, and delete feature flags.
read:feature-flag:jira-softwareView feature flagsView feature flags.
write:deployment:jira-softwareCreate, update, and delete deploymentsCreate, update, and delete deployments.
read:deployment:jira-softwareView deploymentsView deployments.
write:build:jira-softwareCreate, update, and delete buildsCreate, update, and delete builds.
read:build:jira-softwareView buildsView builds.
write:remote-link:jira-softwareCreate, update and delete linksCreate, update and delete links.
read:remote-link:jira-softwareView remote linksView remote links.

Rate this page: