OAuth 2.0 scopes for incoming links
When creating incoming links from external application, you need to select scopes, which are permissions the application can have on your instance.
What the application can do with scopes
As an admin, you can select which scopes the application can request from the authorizing user, but the actual permissions will always be capped at what this user can do. For example, even if you select the ADMIN permissions, the application won't be able to use them if the authorizing user only has WRITE permissions.
Scopes
Here are the scopes you can select when configuring the link. The same scopes will be displayed to users when they authorize the integration. They can later be accessed in their user profile in Authorized applications, where they can also revoke the granted access.
| Scope | Description |
|---|---|
| No scopes selected | View public projects and repositories View projects and repositories that are publicly accessible, including pulling code and cloning repositories. |
| Account | |
| Write | Update your account Update your user account settings. |
| Repositories | |
| Read | View projects and repositories View projects and repositories your account can view, including pulling code, cloning, and forking repositories. Create and comment on pull requests. |
| Write | Update projects and repositories Update projects and repositories your account can change, including pushing code and merging pull requests. |
| Admin | Administer repositories Perform administrative functions on repositories and pull requests your account can change, including deleting pull requests and updating repository settings and permissions. |
| Projects | |
| Admin | Administer projects Perform administrative functions on projects, repositories, and pull requests your account can change, including creating new repositories and updating project settings and permissions. |
| Admin | |
| Write | Administer Bitbucket Perform most administrative functions on the entire Bitbucket instance, excluding functions such as backups, imports, and infrastructure settings which are limited to system administrators. |
| System admin | |
| Write | Administer Bitbucket system Perform all administrative functions on the entire Bitbucket instance, including functions such as backups, imports, and infrastructure settings. |