Skip to content
DigitalOcean Gradient™ AI Agentic Cloud SDK Docs
  • Auto
  • Light
  • Dark

Delete Selective

API Reference
GPU Droplets
Destroy With Associated Resources
Selectively Destroy a Droplet and its Associated Resources
delete/v2/droplets/{droplet_id}/destroy_with_associated_resources/selective

To destroy a Droplet along with a sub-set of its associated resources, send a DELETE request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources/selective endpoint. The JSON body of the request should include reserved_ips, snapshots, volumes, or volume_snapshots keys each set to an array of IDs for the associated resources to be destroyed. The IDs can be found by querying the Droplet's associated resources. Any associated resource not included in the request will remain and continue to accrue changes on your account.

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.

Path ParametersExpand Collapse
droplet_id: number
Body ParametersExpand Collapse
Deprecatedfloating_ips: optional array of string

An array of unique identifiers for the floating IPs to be scheduled for deletion.

reserved_ips: optional array of string

An array of unique identifiers for the reserved IPs to be scheduled for deletion.

snapshots: optional array of string

An array of unique identifiers for the snapshots to be scheduled for deletion.

volume_snapshots: optional array of string

An array of unique identifiers for the volume snapshots to be scheduled for deletion.

volumes: optional array of string

An array of unique identifiers for the volumes to be scheduled for deletion.

curl https://api.digitalocean.com/v2/droplets/$DROPLET_ID/destroy_with_associated_resources/selective \
    -X DELETE \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"
Returns Examples