How to Destroy Apps in App Platform

Last verified 6 Nov 2026

App Platform is a fully managed Platform-as-a-Service (PaaS) that deploys applications from Git repositories or container images. It automatically builds, deploys, and scales components while handling all underlying infrastructure.

Destroying 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.

Destroying an app also destroys its dev databases, but not the managed database clusters attached to it. Managed clusters are separate resources, so they keep running and billing after the app is gone. Before you destroy the app, check the databases section of its app spec: each entry with a cluster_name is a managed cluster. To stop its charges, destroy the cluster separately.

Destroying an app does not destroy the managed database clusters attached to it. Those clusters keep running and billing until you destroy them separately. Each engine in the Managed Databases documentation has its own page for destroying clusters.

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.

How to Destroy an App Using the DigitalOcean CLI
  1. Install doctl, the official DigitalOcean CLI.

  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, run doctl apps delete. Basic usage looks like this, but you can 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

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

cURL

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

Using cURL:

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

Python

Using PyDo, the official DigitalOcean API client for 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, go to the Apps page, select the app you want to destroy, then click the Settings tab.

At the bottom of the page, click Destroy. Enter the app’s name to confirm, then click Destroy.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.