Skip to main content
DELETE
/
api
/
v1
/
databases
/
{id}
/
backups
/
{filename}
Delete backup
curl --request DELETE \
  --url https://api.example.com/api/v1/databases/{id}/backups/{filename}
Deletes a single backup file permanently.

​
Path parameters

ParameterTypeDescription
iduuidDatabase ID
filenamestringBackup filename in YYYYMMDD_HHMMSS.sql.gz format

​
Example

curl -X DELETE \
  -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases/550e8400-e29b-41d4-a716-446655440000/backups/20260326_222551.sql.gz

​
Response

204 No Content

​
Errors

StatusCodeDescription
400INVALID_BACKUP_FILENAMEFilename is not in the expected backup format
401UNAUTHORIZEDMissing or invalid API key
404DATABASE_NOT_FOUNDDatabase doesn’t exist, isn’t owned by this user, or isn’t in scope for this key
404BACKUP_NOT_FOUNDBackup file does not exist
503AGENT_ROUTE_UNAVAILABLEBackup deletion is unavailable until the configured agent is updated
500AGENT_ERRORThe VPS agent failed to delete the backup