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
gpu_droplets.destroy_with_associated_resources.delete_selective(intdroplet_id, DestroyWithAssociatedResourceDeleteSelectiveParams**kwargs)
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.

ParametersExpand Collapse
droplet_id: int
Deprecatedfloating_ips: Optional[List[str]]

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

reserved_ips: Optional[List[str]]

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

snapshots: Optional[List[str]]

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

volume_snapshots: Optional[List[str]]

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

volumes: Optional[List[str]]

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

from gradient import Gradient

client = Gradient()
client.gpu_droplets.destroy_with_associated_resources.delete_selective(
    droplet_id=3164444,
)
Returns Examples