# Delete

Launch stage: Public Preview

`DELETE /api/2.0/database/instances/{name}`

Delete a Database Instance.

API scopes: postgres

## Path parameters

- `name` (string, optional)
  Name of the instance to delete.

## Query parameters

- `force` (boolean, optional)
  By default, an instance cannot be deleted if it has descendant instances created via PITR. If
   this flag is specified as true, all descendent instances will be deleted as well.
- `purge` (boolean, optional)
  Deprecated. Omitting the field or setting it to true will result in the field being hard deleted. Setting a value
   of false will throw a bad request.

## Response

```json
{}
```

