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.

Servers

Path parameters

Name Type Required Description
droplet_id Integer Yes

A unique identifier for a Droplet instance.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
floating_ips[] Array No

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

reserved_ips[] Array No

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

snapshots[] Array No

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

volume_snapshots[] Array No

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

volumes[] Array No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.