Last updated Oct 24, 2022

Manage your apps

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

View your apps

The developer console lets you view information about your apps and integrations, 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 dropdown, select Developer console.

Your apps and integrations are listed with the following details:

  • App name: the name of your app, which can be changed in Settings
  • Distribution status: whether or not you've enabled sharing for your app
  • Updated on: the time and date you created your app or updated its settings
  • Type: the platform or framework used to build your app. To learn more about your options for building an app, see the Cloud development platform overview.

For Jira apps, the app name isn't the name displayed to users in the Jira issue. To change the name that appears in the Jira issue, you need to update the title in the manifest.

Your apps and integrations are listed in the order that they were last updated. You can search for an app using the search bar above the app table.

View Forge app details

Select a 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:

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. For the APIs and scopes to display on the Permissions page, you'll need to deploy your app to the production environment. See Environments and versions for more details.

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 and edit 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.

Delete Forge apps

The process of deleting Forge apps varies, depending on whether you've listed your app on the Atlassian Marketplace or you've distributed your app via the developer console.

Delete a Forge app listing on the Marketplace

By listing a Forge app on the Atlassian Marketplace, the app effectively becomes one of the following:

  • a paid via Atlassian app, if you listed it as a paid app
  • a free app, if you listed it as a free app

To delete a paid via Atlassian Forge app, see the Paid via Atlassian cloud apps only documentation. To delete a free Forge app, see the Free apps documentation.

For both paid via Atlassian and free apps, there are end-of-life (EOL) terms to consider when deleting the app from the Marketplace. The EOL terms only apply to apps with active customers. See Manual retiring of apps for more details.

Delete a Forge app distributed via the developer console

You can delete the app via the console if the app is not installed on a site.

  1. Access the developer console.
  2. Select the app that you want to delete.
  3. Go to Settings in the left menu, and select Delete app.

If the app is currently installed on a site, do one of the following:

  • Uninstall the app from all the sites it's installed on, then delete the app from the console.
  • Submit a ticket at Developer and Marketplace support, and the Atlassian team will uninstall and delete the app for you.

If you created Forge apps using Atlassian accounts based on aliases of the same email, then the list of apps for each account is treated independently. This means you need to uninstall the apps from each account individually.

For example, if you have an Atlassian account associated with simon@example.com, you can create separate Atlassian accounts based on aliases of the account, such as si.mon@example.com and simon+app@example.com. If you signed up for Forge and created apps on all of these accounts, you need to uninstall the apps for each individual account.

Rate this page: