Give Feedback

pydo.droplets.destroy_with_associated_resources_selective()

Generated on 7 Jul 2026 from pydo version v0.39.0

Copy page as Markdown View page as Markdown

Usage

client.droplets.destroy_with_associated_resources_selective(
    droplet_id=3164444,
    body={
        "floating_ips": [...],
        "reserved_ips": [...],
        "snapshots": [...],
        ...,
    },
)

Returns NoneRaises HttpResponseError

Description

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.

Parameters

droplet_id integer required

A unique identifier for a Droplet instance.

Min: 1

floating_ips array of strings optional deprecated

Example: ['6186916']

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

reserved_ips array of strings optional

Example: ['6186916']

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

snapshots array of strings optional

Example: ['61486916']

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

volumes array of strings optional

Example: ['ba49449a-7435-11ea-b89e-0a58ac14480f']

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

volume_snapshots array of strings optional

Example: ['edb0478d-7436-11ea-86e6-0a58ac144b91']

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

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

resp = client.droplets.destroy_with_associated_resources_selective(droplet_id=524512)

More Information

See /v2/droplets/{droplet_id}/destroy_with_associated_resources/selective in the API reference for additional detail on responses, headers, parameters, and more.