> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dbhost.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete backup

> Delete one backup file for a database.

Deletes a single backup file permanently.

## Path parameters

| Parameter  | Type   | Description                                        |
| ---------- | ------ | -------------------------------------------------- |
| `id`       | uuid   | Database ID                                        |
| `filename` | string | Backup filename in `YYYYMMDD_HHMMSS.sql.gz` format |

## Example

```bash theme={null}
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

```http theme={null}
204 No Content
```

## Errors

| Status | Code                      | Description                                                                      |
| ------ | ------------------------- | -------------------------------------------------------------------------------- |
| 400    | `INVALID_BACKUP_FILENAME` | Filename is not in the expected backup format                                    |
| 401    | `UNAUTHORIZED`            | Missing or invalid API key                                                       |
| 404    | `DATABASE_NOT_FOUND`      | Database doesn't exist, isn't owned by this user, or isn't in scope for this key |
| 404    | `BACKUP_NOT_FOUND`        | Backup file does not exist                                                       |
| 503    | `AGENT_ROUTE_UNAVAILABLE` | Backup deletion is unavailable until the configured agent is updated             |
| 500    | `AGENT_ERROR`             | The VPS agent failed to delete the backup                                        |