Delete Databases

Delete Database

DELETE /v1/databases/{uuid}

Delete a database. It is marked deleting and ngris then drops the database, its users and all of its data. This can't be undone. Requires Databases delete.

The delete is refused while any application uses the database: through a connection (the database POST /v1/applications/{uuid}/database creates is one too), or, for an older per-app database not moved onto a connection, as its app's own (legacy: true: it can't be disconnected; the database becomes deletable once that app is deleted). Disconnect each app with DELETE /v1/applications/{uuid}/database-connections/{connection_uuid}, then retry. A paused database can be deleted; deleting one that is already deleting answers 202 again.

Response (202 Accepted)

{"database": {…}} with status: "deleting" (database object). The database no longer counts against your plan's limit.

Errors

403

No Databases delete, no active account, or no managed databases on the plan.

404

database not found.

409

database_in_use: applications use the database. connected_apps lists them ({application_uuid, application_name}).

503

databases_unavailable.

Request
curl -X DELETE "https://api.ngris.com/v1/databases/019c2a41-7d3e-7b52-a1c4-5e9f0b3d6a18" \
  -H "X-API-KEY: <your_api_key>"

Response — 202 Accepted
{
  "database": {
    "uuid": "019c2a41-7d3e-7b52-a1c4-5e9f0b3d6a18",
    "name": "orders-db",
    "engine": "mariadb",
    "status": "deleting",
    "placement": "shared",
    "db_name": "app_orders_db_k3x9q2tm",
    "host": "mariadb-apps.ngris-appdb.svc.cluster.local",
    "port": 3306,
    "size_bytes": null,
    "size_measured_at": null,
    "quota_paused": false,
    "connected_app_count": 0,
    "user_count": 0,
    "created_at": "2026-10-18T09:00:00Z",
    "updated_at": "2026-10-18T11:00:00Z"
  }
}

Response — 409 (in use)
{
  "error": "This database is used by 1 application: disconnect it first.",
  "code": "database_in_use",
  "connected_apps": [
    { "application_uuid": "019be838-d261-7d9b-9499-71995a3a91c6", "application_name": "orders-api" }
  ]
}

PreviousRename Database NextDatabase Users

On this page

Delete Database