Skip to content
  • Auto
  • Light
  • Dark

Delete By Name

Delete a Block Storage Volume by Name
delete/v2/volumes

Block storage volumes may also be deleted by name by sending a DELETE request with the volume's name and the region slug for the region it is located in as query parameters to /v2/volumes?name=$VOLUME_NAME&region=nyc1. No response body will be sent back, but the response code will indicate success. Specifically, the response code will be a 204, which means that the action was successful with no returned body data.

Query ParametersExpand Collapse
name: optional string

The block storage volume's name.

region: optional "ams1" or "ams2" or "ams3" or 12 more

The slug identifier for the region where the resource is available.

Accepts one of the following:
"ams1"
"ams2"
"ams3"
"blr1"
"fra1"
"lon1"
"nyc1"
"nyc2"
"nyc3"
"sfo1"
"sfo2"
"sfo3"
"sgp1"
"tor1"
"syd1"
curl https://api.digitalocean.com/v2/volumes \
    -X DELETE \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"
Returns Examples