To destroy a Droplet along with all of its associated resources, send a DELETE
request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources/dangerous
endpoint. The headers of this request must include an X-Dangerous
key set to
true
. To preview which resources will be destroyed, first query the
Droplet’s associated resources. This operation can not be reverse and should
be used with caution.
A successful response will include a 202 response code and no content. Use the status endpoint to check on the success or failure of the destruction of the individual resources.
Name | Type | Required | Description | Default Value |
---|---|---|---|---|
droplet_id |
integer | True | A unique identifier for a Droplet instance. | |
X-Dangerous |
boolean | True | Acknowledge this action will destroy the Droplet and all associated resources and can not be reversed. |
import os
from pydo import Client
client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
resp = client.droplets.destroy_with_associated_resources_dangerous(droplet_id=524512)
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.