---
title: "delete database"
method: DELETE
path: "/databases/{id}"
tags: ["Databases"]
---

# delete database

`DELETE /databases/{id}`

## Request

- Base URL: `https://api.aptible.com`
- URL: `https://api.aptible.com/databases/{id}`
- Auth: API key in header `Authorization`

Deletes a database by ID.

## Path parameters

- `id` integer, required

## Query parameters

- `with_deleted` boolean

## Response `204`

successful

## Other responses

- `default`: Error response. Often a 4xx or 5xx status code

## Changes

- **2026-08-24** `0bd1bb990024`: 1 info
  - added the new optional `query` request parameter `with_deleted`

[Operation history](https://skmtc.dev/aptible/apis/aptible-api-v1/changes/databases/:id/delete.md)

---

[API](https://skmtc.dev/aptible/apis/aptible-api-v1.md) - [All operations](https://skmtc.dev/aptible/apis/aptible-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/aptible/apis/aptible-api-v1/revisions/a21f6b1bc6fe?raw)