Skip to content
  • Auto
  • Light
  • Dark

Delete By Tag

Deleting Droplets by Tag
delete/v2/droplets

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.

This endpoint requires tag:read scope.

A successful request will receive a 204 status code with no body in response. This indicates that the request was processed successfully.

Query Parameters
tag_namestring

Specifies Droplets to be deleted by tag.

curl https://api.digitalocean.com//v2/droplets \
    -X DELETE \
    -H "Authorization: Bearer $GRADIENTAI_API_KEY" \
    -d '{}'