Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Aug 5, 2026

Grant roles to Forge apps using 2LO (app-only access)

When a Forge app calls the Assets REST API with 2LO (two-legged OAuth), the request is authenticated as the app itself rather than on behalf of a logged-in user. In the Forge managed APIs, this is the asApp() call, as opposed to the asUser() (3LO) call that acts on behalf of a user.

The app account has no access to Assets data by default. An admin must explicitly grant the app the Assets roles it needs for every operation it performs with 2LO.

How Assets authorizes a request

Assets uses a layered security model. Even after your app passes API authentication and API authorization, a request must still clear role-based authorization: the requester must hold the Assets roles required to access the target data. See Authorization for the full security model.

For a 2LO app, the "requester" is the app. So granting the right roles to the app is what makes its requests succeed.

Determine the roles your app needs

Assets roles control what an identity can view or change, and they can be assigned at different scopes. Grant the least-privileged role that still covers your app's operations.

Assets provides a set of roles, such as Users, Developers, and Managers, that grant progressively more access. For the full list of roles and exactly what each one allows, see Roles in Assets.

Map each operation your app performs to the least-privileged role that covers it. For example, an app that reads or edits objects needs the Users role, while an app that changes attributes or object types needs at least the Developers role on the relevant schema or object type.

Grant a role to the app

You add an app to a role the same way you add a user or group, in the Roles tab of a schema or object type, apps can be added alongside users and groups. You must be logged in as an Assets admin with Jira access.

Add the app to an object schema role

Grant a schema-level role when the app operates across an entire object schema.

  1. Go to Assets and select Schemas.
  2. Select the object schema you want to grant access to.
  3. Select Schema configuration.
  4. Open the Roles tab.
  5. In the row for the role you want to grant, select the field under Apps and start typing to find your app, then select it.
  6. Press Enter to confirm.

This mirrors Add users or groups to an object schema role.

Add the app to an object type role

Grant an object type role when the app only needs access to a single object type.

  1. Go to Assets and select Schemas.
  2. Select the object schema, then select the object type.
  3. Select More actions (•••) next to the object type name, then Configure object type.
  4. Open the Roles tab.
  5. In the row for the role you want to grant, select the field under Apps and start typing to find your app, then select it.
  6. Select Update to save.

This mirrors Add users or groups to an object type role.

Grant access for every operation

The app can only perform an operation if it has been granted a role that covers it. If your app performs operations across multiple schemas or object types, repeat the steps above for each one. A missing or insufficient role results in an authorization failure for that request, even when the app's OAuth scopes are correct.

Scopes and roles are separate layers and both are required:

Rate this page: