How to Destroy Apps in App Platform

App Platform is a Platform-as-a-Service (PaaS) offering that allows developers to publish code directly to DigitalOcean servers without worrying about the underlying infrastructure.


Deleting an app permanently and irreversibly destroys the app and its components. If you need to re-deploy the app, you can download the app specification file before deleting the app and use the saved spec to build the app again.

Destroy an App Using Automation

The destroy app CLI command and API endpoint require the app’s ID. You can retrieve a list of your apps and their IDs using the doctl apps list command or the /v2/apps endpoint endpoint.

How to destroy an app using the DigitalOcean CLI

To destroy an app via the command-line, follow these steps:

  1. Install doctl, the DigitalOcean command-line tool.

  2. Create a personal access token, and save it for use with doctl.

  3. Use the token to grant doctl access to your DigitalOcean account.

                  doctl auth init
                
  4. Finally, destroy an app with doctl apps delete. The basic usage looks like this, but you'll want to read the usage docs for more details:

                  doctl apps delete <app id> [flags]
                

    The following example deletes an app with the ID f81d4fae-7dec-11d0-a765-00a0c91e6bf6

                       doctl apps delete f81d4fae-7dec-11d0-a765-00a0c91e6bf6
                    
How to destroy an app using the DigitalOcean API

To destroy an app using the DigitalOcean API, follow these steps:

  1. Create a personal access token, and save it for use with the API.

  2. Send a DELETE request to https://api.digitalocean.com/v2/apps/{id}

    cURL

    To destroy an app with cURL, call:

    
                    curl -X DELETE \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
      "https://api.digitalocean.com/v2/apps/{id}"

    Python

    
                    import os
    from pydo import Client
    
    client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
    
    delete_resp = client.apps.delete(id="b7d64052")

Destroy an App Using the Control Panel

To destroy an app from the DigitalOcean Control Panel, click Apps from the left menu and the click on the app you want to destroy.

From the app’s overview page, click the Settings tab. Scroll down to the Destroy section and then click the Destroy button. In the Destroy app and associated components window, enter the app’s name into the field to confirm that you want to destroy the app and then click Destroy. The app is deleted from your account.