Update your app

Apps can be edited, updated, or deleted through the developer console. Unpublished (apps not in the App Directory) can be modified at any time. However, if your app is published, we do not permit you to edit the app. To update a published app, we recommend duplicating the app and submitting the edits to Asana by "submitting for review" again. To delete at published app, please reach out via https://asana.com/support.

Editing app directory content

If you only need to edit the content of your app in the App Directory you can reach out via https://asana.com/support to help get that updated. Otherwise, if you need to update both your app directory content and published app, please follow the instructions below.

Editing a published app

Developers can submit updates to an app that is already published in the Asana App Directory. Because published apps cannot be edited directly, you’ll follow a short workflow to duplicate, update, and resubmit your changes.

1. Duplicate your app

Published apps are read-only, so the first step is to duplicate your app . The duplicated app receives its own ID and acts as a separate instance, but it remains linked to the original app. This connection allows us to apply any approved changes from the duplicated version back to the published version.

2. Edit your app

Make any necessary updates — for example:

  • Redirect URIs
  • Permissions or scopes
  • App details such as the short or long description
  • App icon

You can test freely using the duplicated app without affecting the currently published listing.

3. Submit the updated version for review

When your updates are ready, submit the app for review:

  1. Open Submit for review in the sidebar of your duplicated app.
  2. In the Submission type dropdown, choose I'm submitting changes to a published app.
  3. Add clear and detailed submission notes so our team understands exactly what has changed.

4. Review process begins

After submission, your app enters the standard review workflow.
You’ll typically hear from us within about one week, though timing may vary depending on the scope of the changes.

Once approved, the updates made in the duplicated app will be applied to the original published app.

Duplicating an app

You can quickly create a brand new app with the same configurations of an existing one by selecting Duplicate app in the developer console.

This feature can help streamline the creation and management of different versions (e.g., staging, beta, production, etc.) of your application. As a result of this operation, the newly-generated app will retain the configurations of the original app, including:

  • Basic information (e.g., app name, descriptions, authentication URL, etc.)
  • Configurations of app components

Because the newly-generated app is its own unique app, the following will not be carried over from the original app:

  • App credentials (i.e., a new client ID and client secret will be generated)
  • Users who have completed OAuth
  • Organizations in which the app is available
  • Published listings in the app directory or app gallery

Delete a published app

To delete at published app, please reach out via https://asana.com/support.

Transfer app ownership

Domain administrators can request for Asana to transfer an OAuth application to another user in the domain. To begin the process, please complete and submit this form.


Asana Footer
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.