> ## 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 database

> Queue a guarded, recoverable deletion for a managed database.

Queues guarded database deletion. The request must confirm the exact internal
database name. DBHost creates and verifies a deletion backup, removes routing,
and creates a tombstone with a seven-day self-service recovery window. The
tombstone does not consume active database quota but reserves the name.

<Warning>
  Deletion requires an authenticated API key with access to the database, the
  exact managed-registry/OID identity, a verified backup and a bound operation
  ID. Unsafe, unmanaged and protected targets receive
  `FEATURE_NOT_AVAILABLE`; a name alone is never authority.
</Warning>

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `id` | uuid | Canonical database ID |

## Request

```json theme={null}
{
  "confirmationName": "exact_internal_database_name"
}
```

The operation validates ownership, database ID/name binding, managed-registry
membership, destructive capability, and the permanent protected-target list.
Names alone are never sufficient authorization.

## Response

```json 202 Accepted theme={null}
{
  "message": "Database deletion queued",
  "operation": {
    "id": "op_01J...",
    "type": "delete",
    "status": "queued",
    "stage": "verify_deletion_backup",
    "progress": 0
  }
}
```

Poll `GET /api/v1/operations/{id}`. After success, use the deleted-databases
endpoint to inspect the recovery deadline or queue recovery while quota permits.

## Errors

| Status | Code | Description |
| - | - | - |
| 400 | `CONFIRMATION_REQUIRED` | Typed name does not match the bound database |
| 401 | `UNAUTHORIZED` | Missing or invalid API key |
| 404 | `DATABASE_NOT_FOUND` | Database is missing or outside key scope |
| 404 | `FEATURE_NOT_AVAILABLE` | Feature is disabled or the target is not a safe managed tenant database |
| 409 | `OPERATION_CONFLICT` | Another destructive operation is active |
| 409 | `BACKUP_NOT_VERIFIED` | Required deletion backup is not verified |
| 503 | `AGENT_CAPABILITY_UNAVAILABLE` | Agent cannot execute guarded deletion |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.