Forge Scopes Justification
Scope | Purpose in Report Hub | Why It's Needed |
|---|---|---|
manage:jira-configuration | Configure app settings | Required for the admin configuration page (jira:adminPage) to save global settings |
manage:jira-project | Manage project settings | Configure project-specific Hub / report settings |
read:jira-work | Read issues, comments, worklogs | Read issue data to generate reports and Hubs |
read:jira-user | Read user information | Display user names, avatars, and details in reports |
write:jira-work | Create/update issues, comments | Update issues directly from reports |
storage:app | Store app data | Store report configs, Hub entries, user preferences, Hub settings |
read:application-role:jira | Read application roles | Check permissions for viewing/editing Hubs |
read:group:jira | Read Jira groups | Filter reports by group and control Hub access |
read:user:jira | Read user profiles | Get detailed user info for attribution and filtering |
read:connect-jira | Read Connect app data | Support additional field types in reports |
write:connect-jira | Write Connect app data | Edit additional field types in reports |
read:sprint:jira-software | Read sprint information | Generate sprint-based reports |
read:board-scope:jira-software | Read board data | Access boards for Agile report configuration |
read:board-scope.admin:jira-software | Read board admin settings | Advanced board-level reporting configuration |
read:project-version:jira | Read versions/releases | Generate release/version-based reports |
read:issue-details:jira | Read detailed issue data | Access full issue details incl. custom fields |
write:user.property:jira | Store user preferences | Save per-user settings (favorites, views, filters) |
read:jql:jira | Execute JQL queries | Run custom JQL for report filtering (core to Report Hub) |
read:workflow:jira | Read workflow information | Show workflow status, progression, time-in-status |
read:project:jira | Read project details | Fetch project metadata for project-level Hub pages |
read:project-role:jira | Read project roles | Control Hub visibility by project roles |
read:filter:jira | Read saved filters | Base reports on existing Jira filters |
read:issue-type-hierarchy:jira | Read issue type hierarchy | Support Epic/Story/Subtask rollups and custom hierarchies |