Atlassian Connect app scopes

When you install an Atlassian Connect app (also known as an add-on or plugin), you're prompted to approve and accept the scopes of the app. This page explains what scopes are, and the breadth of scopes an app might have.

What are scopes?

Scopes are essentially app capabilities –  things apps can do to interact with your product instance. An app might need permission to read, write, or delete data in order to integrate with your product instance. 

Atlassian Connect apps are hosted remotely, outside your product instance, so they need explicit permission to integrate with your product.

Possible scopes

The following table includes all possible scopes.

Host applicationScopeCapabilities
JIRA Cloud &
Confluence Cloud
ReadRead data from the host application
WriteWrite data to the host application
DeleteDelete data from the host application
Project administrationAdminister JIRA projects
Space administrationAdminister Confluence spaces
Act as userAct on a user's behalf, even when the user is offline
Full AdministrationAdminister the host application
Access Email Addresses

Access email addresses for all users in the system.

Bitbucket CloudRepositoryRead access to all the repositories the authorizing user has access to
Edit RepositoryWrite (not admin) access to all the repositories the authorizing user has access to
Administer RepositoryAdministrator access to all the repositories the authorizing user has access to
SnippetRead access to all the snippets the authorizing user has access to
Edit SnippetWrite access to all the snippets the authorizing user can edit
IssueAbility to interact with issue trackers the way non-repo members can
Manage IssueAbility to view, create, comment, watch, transition and delete issues
WikiAccess to Wikis
Pull RequestRead access to pull requests and collaborate on them
Edit Pull RequestAccess to pull requests, and ability to create, merge and decline them
EmailAbility to see the user's primary email address
AccountAbility to see all the user's account information
Manage AccountAbility to change properties on the user's account
TeamAbility to find out what teams the current user is part of
Manage TeamAbility to manage the teams that the authorizing user is an admin on
WebhookAccess to webhooks
ProjectAccess to projects
Edit ProjectAbility to change properties on a project
Last modified on Mar 10, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.