Forge Developer

Beta

Forge Developer

Beta
Last updatedDec 9, 2020

Rate this page:

Manage your apps

You can securely manage all your Forge and OAuth 2.0 (3LO) apps in one place using the Atlassian developer console.

View your apps

The developer console lets you view information about your Forge and 3LO apps, including their scopes and environments.

To access the console:

  1. From any page on developer.atlassian.com, select your profile icon in the top-right corner.

  2. From the drop-down, select Developer console.

Your existing Forge and 3LO apps are listed in the order that they were created. 3LO apps are displayed with a 3LO lozenge.

Connect apps are not listed in the console. To learn more about your platform and framework options for building apps, see the Cloud development platform overview.

The following details are listed:

  • App name: the name of your app

  • Distribution status:

    • Public: your app can be shared with others
    • In development: your app can't be shared with others
  • Updated on: the time and date you created your app or updated its settings

You can search for an app using the search bar above the app table.

View Forge app details

Select any Forge app on the My apps screen to get more information about it, including app ID, environments, and permissions.

The Overview page displays the following panels:

  • App details

    • App ID: The identifier for your Forge app
    • App environments: The three available environments for your Forge app
    • Currently deployed to: Which of the three environments your Forge app is currently deployed to
  • Permissions

    • API scopes: the API scopes currently included in your Forge app’s manifest file. See View Forge app permissions below for more information.

Select Settings in the left menu to view your Forge app’s name, platform type, and avatar.

View Forge app permissions

You can view the level of access your Forge app has to an Atlassian user’s account by selecting Permissions in the left menu, or selecting the Permissions panel.

The Permissions page lists the APIs included in your Forge app, where you have added at least one scope from that API to your app's manifest file.

To see the individual scopes for an API, select View.

Note, you can’t configure scopes for a Forge app from the developer console. To add scopes, see Add scopes to call an Atlassian REST API.

To learn more about Forge app permissions, see Security. For more information about individual scopes, see Permissions.

Create, edit, and delete Forge apps

Any new Forge apps you create using the CLI appear in the console, and any changes you make to existing Forge apps using the CLI are reflected in the console.

A Forge app can only be deleted if it's not installed anywhere.

  1. If your app is currently installed on a site, uninstall it.
  2. Got to Settings in the left menu, and select Delete app.

Distribute Forge apps

You can manually distribute your Forge app by sharing a copy of your app's code. Your user will then need to run the forge register, forge deploy, and forge install commands to register the app for their own account.

Forge apps are not yet available for distribution using the developer console, but this functionality is coming soon.

Rate this page: