Add-on scopes

When you install an Atlassian Connect add-on, you're prompted to approve and accept the scopes of the add-on. This page explains what scopes are, and the breadth of scopes an add-on might have.

What are scopes?

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

Atlassian Connect add-ons 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 add-on scopes.

Host application Scope Add-on capabilities
JIRA Cloud &
Confluence Cloud
Read Read data from the host application
Write Write data to the host application
Delete Delete data from the host application
Project administration Administer JIRA projects
Space administration Administer Confluence spaces
Act as user Act on a user's behalf, even when the user is offline
Full Administration Administer the host application
 HipChat Administer Group Perform group administrative tasks
Administer Room Perform room administrative tasks
Manage Rooms Create, update, and remove rooms
Send Message Send private one-on-one messages
Send Notification Send room notifications
View Group View users, rooms, and other group information
View Messages View messages from chat rooms and private chats you have access to
View Room View room information and participants, but not history
Stride Manage conversation Create, update and archive conversations
Participate in conversation Send and receive messages in conversations it's installed in; and access all the information it needs to participate in conversations
View user profile Access user data
Bitbucket Cloud Repository Read access to all the repositories the authorizing user has access to
Edit Repository Write (not admin) access to all the repositories the authorizing user has access to
Administer Repository Administrator access to all the repositories the authorizing user has access to
Snippet Read access to all the snippets the authorizing user has access to
Edit Snippet Write access to all the snippets the authorizing user can edit
Issue Ability to interact with issue trackers the way non-repo members can
Manage Issue Ability to view, create, comment, watch, transition and delete issues
Wiki Access to Wikis
Pull Request Read access to pull requests and collaborate on them
Edit Pull Request Access to pull requests, and ability to create, merge and decline them
Email Ability to see the user's primary email address
Account Ability to see all the user's account information
Manage Account Ability to change properties on the user's account
Team Ability to find out what teams the current user is part of
Manage Team Ability to manage the teams that the authorizing user is an admin on
Webhook Access to webhooks
Project Access to projects
Edit Project Ability to change properties on a project
Last modified on Sep 8, 2017

Was this helpful?

Yes
No
Provide feedback about this article

Not finding the help you need?

Ask the community

Powered by Confluence and Scroll Viewport.