How to Destroy a MicroVM

Last verified 17 Nov 2026

DigitalOcean MicroVMs are lightweight virtual machines that run a container image in an isolated kernel, pause automatically when idle, and resume on the next request with memory, files, and processes intact.

Destroying a DigitalOcean MicroVM permanently deletes the MicroVM and the data on its disk. It also revokes the MicroVM’s access tokens, removes its URLs, and removes it from its project.

Its checkpoints are not deleted. However, if the MicroVM has environment variables or outbound credentials, you cannot create MicroVMs from its checkpoints after you destroy it. For details, see MicroVM Checkpoints. To delete checkpoints, see How to Checkpoint a MicroVM.

You cannot destroy a MicroVM while it is still being created or while a checkpoint of it is being captured. Wait for the operation to finish, then try again.

Destroy a MicroVM Using the Control Panel

Go to the MicroVMs page, select the MicroVM, click the Settings tab, then click Destroy. You can also open the MicroVM’s … menu on the MicroVMs page and click Destroy.

In the Destroy MicroVM window, type the MicroVM’s name into the field, then click Destroy.

Destroy a MicroVM Using doctl

Delete the MicroVM. You can pass more than one MicroVM ID. The command prompts for confirmation, and --force skips the prompt.

How to Permanently Delete One or More MicroVMs 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 compute microvm delete. Basic usage looks like this, but you can read the usage docs for more details:
    doctl compute microvm delete <microvm-id>... [flags]

Destroy a MicroVM Using the API

Send a DELETE request to /v2/microvms/<your-microvm-id>.

How to Delete a MicroVM 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/microvms/{microvm_id}.

Using cURL:

curl -X DELETE \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/microvms/01a0ef1a-d873-793d-ae6a-5dd6239be62a"

A successful request returns HTTP 204. The request returns HTTP 400 while the MicroVM is being created or a checkpoint of it is being captured.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.