Forge Scopes
When installing the ScriptRunner Behaviours Forge app a list of permissions, or Jira Core scopes and Jira Software scopes, are presented for approval. This is required by the app in order to run successfully.
A list of the scopes required for each REST API endpoint that JIRA Cloud provides can be found here. You can refer to the descriptions provided below to understand why we need each of these scopes:
| Scope name | Scope Title | Description |
|---|---|---|
| App storage scope | Allows the Behaviours app to store required data for running Behaviours apps within Forge storage. |
read:project:jira | View projects | Grants permission to allow the Forge apps to view projects within the Jira Cloud instance. |
| View Jira issue data | Reads Jira project and issue data, searches for issues and objects associated with issues such as attachments and worklogs. |
| View user profiles | Views user information in Jira that the user has access to, including usernames, email addresses, and avatars. |
| Manage Jira global settings | Undertakes Jira administration actions, for example, create projects and custom fields, view workflows, and manage issue link types. |
| Create and manage issues | Creates and edits issues in Jira, post comments as the user, create worklogs, and delete issues. |
| Manage project settings | Creates and edits project settings and creates new project-level objects, for example, versions and components. |
| Manage Jira webhooks | Manages Jira webhooks, including fetch, register, refresh, and delete dynamically declared Jira webhooks. |
| View board configuration | Views the configuration, project features, filters, properties, and quick filters for a board. |
| View boards, backlogs, and related items | Views boards, issues on a board, issues from a backlog, reports, and versions. |
| View issue details | Allows all details on an issue to be viewed by the Forge app. |
| View epics and related issues | Views and searches for epics, and issues related to an epic. |
| View JQL | Allows JQL searches to be viewed and run by the Forge app. |
| View sprints | Views sprints and sprint-related issues and properties. |
| View issues | Views issues, issue estimations, and the field used for estimations. |