Skip to content
Gradient SDK Docs
  • 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 Parameters
namestring
optional

The block storage volume's name.

regionenum
optional
"ams1" OR "ams2" OR "ams3" OR 12 more

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

Hide ParametersShow Parameters
"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 $GRADIENTAI_API_KEY"