v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_Droplets

Selectively Destroy a Droplet and its Associated Resources

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.

delete/v2/droplets/{droplet_id}/destroy_with_associated_resources/selective

Path parameters

droplet_idinteger required

A unique identifier for a Droplet instance.

Request body

floating_ipsstring[]

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

reserved_ipsstring[]

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

snapshotsstring[]

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

volumesstring[]

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

volume_snapshotsstring[]

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

Example request

{
  "floating_ips": [
    "6186916"
  ],
  "reserved_ips": [
    "6186916"
  ],
  "snapshots": [
    "61486916"
  ],
  "volumes": [
    "ba49449a-7435-11ea-b89e-0a58ac14480f"
  ],
  "volume_snapshots": [
    "edb0478d-7436-11ea-86e6-0a58ac144b91"
  ]
}

Response

This does not indicate the success or failure of any operation, just that the request has been accepted for processing.