pydo.droplets.destroy_by_tag()
Generated on 1 May 2025
from pydo
version
v0.11.0
Description
To delete all Droplets assigned to a specific tag, include the tag_name
query parameter set to the name of the tag in your DELETE request. For
example, /v2/droplets?tag_name=$TAG_NAME
.
A successful request will receive a 204 status code with no body in response. This indicates that the request was processed successfully.
Parameters
Name | Type | Required | Description | Default Value |
---|---|---|---|---|
tag_name |
string | True | Specifies Droplets to be deleted by tag. |
Request Sample
import os
from pydo import Client
client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
resp = client.droplets.destroy_by_tag(tag_name="production")
More Information
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.