Display conditions
Permissions
Translations
Last updated Nov 1, 2024

Forge scopes

Certain platform features, such as the App storage API, are authenticated using OAuth 2.0.

ScopeDescription
read:app-system-token

Enables Forge to pass a token to a remote backend, that can be used to invoke Atlassian app REST APIs with the permissions of the app "bot" user.

For more information see Forge Remote.

read:app-user-token

Enables Forge to pass a token to a remote backend, that can be used to invoke Atlassian app REST APIs with the permissions of the logged-in user.

Only app modules can have this scope, because they are associated with a logged-in user session. App event and lifecycle event modules are not associated with a logged-in user session, therefore they cannot have this scope.

For more information Forge Remote.

storage:appEnables the App storage API.
report:personal-dataEnables the User privacy API.
read:chat:rovoEnables actions from your Forge app to be used by agents created by customers.

Atlassian app scopes

Atlassian app scopes enable a Forge app to request a level of access to an Atlassian app. You can find details about each Atlassian app operation's required scopes through the REST API documentation (specifically, in the operation's Oauth scopes required field). For information about each Atlassian app event's required scopes, see our events documentation.

For more details about each Atlassian app's OAuth 2.0 (3LO) and Forge scopes, refer to the pages below:

Rate this page: