--- title: "Jira" slug: "jira" updated: 2025-07-13T14:52:54Z published: 2025-07-13T14:52:54Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.unleash.so/llms.txt > Use this file to discover all available pages before exploring further. # Jira ## Connection A connection to Jira can be established via an API Token or an OAuth2 (SSO) connection. The primary distinction between an API Token and an SSO connection lies in their scope and longevity. The API Token does not offer scoping options (permission granularity), whereas the SSO connection does. Conversely, an API Token is perpetual and requires no renewal, whereas an SSO connection may necessitate periodic reconnection per Atlassian's token policy. ## API Token An API Token can be generated through the Atlassian User Interface. This is accessible on the security page of the user's profile. For more information, please visit: [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens). ## SSO Connection For SSO the connection will use the connecting user credentials requesting the following read scopes. For an SSO connection, the connecting user's credentials will be utilized. This process involves requesting the following read scopes: ```plaintext read:user:jira read:application-role:jira read:avatar:jira read:group:jira read:project-role:jira read:issue-type-hierarchy:jira read:issue-type:jira read:project-category:jira read:dashboard:jira read:project.component:jira read:project-version:jira read:project.property:jira read:project:jira read:workflow:jira read:attachment:jira read:issue:jira read:issue-worklog:jira read:status:jira read:issue-status:jira read:issue-details:jira read:issue-meta:jira read:audit-log:jira read:field-configuration:jira read:field:jira read:jql:jira read:webhook:jira write:webhook:jira delete:webhook:jira read:issue-security-level:jira read:issue.changelog:jira read:issue.vote:jira read:me offline_access ``` A full list of scopes and descriptions can be found here: [https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/) ## Supported Resources - Issues ## Filtering and Selection When establishing a connection, it is feasible to refine the index scope of the connected account by selecting specific projects. This feature allows for more targeted indexing based on the user's requirements. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1720516223099.png) It is crucial to note that narrowing down the indexing scope does not impact the scope of the token (credentials). This means the token retains access to all available projects, regardless of the selected indexing scope. ## Sync - The integration retrieves all issues from the selected projects during the connection process. - Following the initial synchronization, the integration updates with any changes in each project every 15 minutes. ****API Calls**** The table below outlines the primary endpoints utilized by the integration - | Endpoint | Docs | Purpose | | --- | --- | --- | | /rest/api/3/project/search | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get) | List and filter for selected projects | | /rest/api/3/search | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-get) | List issues of a project | | /rest/api/3/issuetype | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-types/#api-rest-api-3-issuetype-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-types/#api-rest-api-3-issuetype-get) | Get information of custom issue types (icons, names etc) | | /rest/api/3/issue/{issueIdOrKey} | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get) | Get a specific issue in order to list its comments | ## Resource Level Permissions (RLP) RLP is available for Jira, ensuring that any shared link adheres to the permissions set within Jira. Currently, RLP enforces permissions at the project level. Efforts are underway to extend this to the issue level. For more details on RLP Links and other link types, refer to our general RLP documentation. ## Prerequisite To enable RLP mode for Jira, you must first install our Atlassian Connect App. This app facilitates indexing and syncing user and group directories, allowing for permission enforcement based on these parameters. ## Installation Guide Follow these steps to install the app: ## Atlassian (JIRA, Confluence) Installation for Permission Based Link 1. Sign in to your JIRA/Confluence workspace. If you are already signed in and have multiple workspaces, ensure you are signed into the correct account for the intended workspace. 2. Go to **Apps** > **Manage your apps.** > [!NOTE] > To connect Jira as a Permission-Based Link, you must complete this setup within your Jira instance. Similarly, to connect Confluence as a Permission-Based Link, a separate installation is required within Confluence. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1722168373345.png) 1. Click on **Settings at** the bottom of the page. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1725174067812(1).png) 1. Ensure that the **Enable private listings** and **Enable development mode** options are checked and hit **Apply**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1722168428630.png) 1. Refresh the page, and click on the **Upload app** button that appears. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1725174279807(2).png) 1. Fill in the app descriptor URL - the value depends on your installation: 1. For Jira use - `https://jira.unleashing.app/install/descriptor/` ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1720516319296.png) 1. Wait for the app to install successfully. Please let us know if the installation fails. ## Scopes The required scopes for the Connect App are: ```plaintext ADMIN ACT_AS_USER ACCESS_EMAIL_ADDRESSES READ ``` A comprehensive list of scopes and their descriptions is available here: [Atlassian Connect App Scopes](https://developer.atlassian.com/cloud/jira/software/scopes-for-connect-apps/). ## Connection There are two methods to connect the RLP link: 1. **As App User**: Accesses resources based on a user created for the installed app (Unleash) in the previous step. 2. **As Impersonated User**: Accesses resources based on the credentials of the connecting user. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1720516358687.png) ****Additional API Calls**** The following table is additional endpoints that are used for enforcing permissions: | Endpoint | Docs | Purpose | | --- | --- | --- | | /rest/api/3/user/search | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search#api-rest-api-3-user-search-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search#api-rest-api-3-user-search-get) | List users connected to Jira | | /rest/api/3/user/email/bulk | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-user-email-bulk-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-user-email-bulk-get) | Match Jira accounts with email addresses | | /rest/api/3/group/bulk | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/#api-rest-api-3-group-bulk-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/#api-rest-api-3-group-bulk-get) | List groups connected to Jira | | /rest/api/3/group/member | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/#api-rest-api-3-group-member-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/#api-rest-api-3-group-member-get) | List all members of specific group | | /rest/api/3/project/{projectKeyOrId}/permissionscheme | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-permission-schemes/#api-rest-api-3-project-projectkeyorid-permissionscheme-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-permission-schemes/#api-rest-api-3-project-projectkeyorid-permissionscheme-get) | Get the assigned project permissions scheme | | /rest/api/3/project/{projectIdOrKey}/role | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-roles/#api-rest-api-3-project-projectidorkey-role-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-roles/#api-rest-api-3-project-projectidorkey-role-get) | Get the roles for specific project | | /rest/api/3/project/{projectIdOrKey}/role/{id} | [https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-roles/#api-rest-api-3-project-projectidorkey-role-id-get](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-roles/#api-rest-api-3-project-projectidorkey-role-id-get) | Get the role details of a specific role in project | ****Example Questions**** - Which kind of quoting system can ACME integrate with? - Where can I find documentation about the ACME API? - When a file, record, or data is deleted in our app, how long does the data remain in a recoverable state? - What configuration parameter can be used to significantly reduce ABC task time? - Where are the release notes for the latest version? ****FAQ’s**** - **Does Unleash support Jira Service Management?** Unleash supports Jira Service Management. - **Do we support issue-level permissions for Jira?** This is not something that Unleash currently supports. If this is something your business requires please reach out to your Unleash representative.