pydo.droplets.destroy_with_associated_resources_dangerous()
Generated on 20 Oct 2025
from pydo version
v0.18.0
Description
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.
Parameters
| 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. |
Request Sample
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)More Information
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.