v1

latestOpenAPI 3.1.0Proprietary2026-07-262570100.1 KB
database-management

Delete a database

Delete a database and all associated data

delete/databases

Query parameters

databasestring required
Example:acme_corp

Database identifier to delete

Response

OK

successboolean

Whether the request succeeded.

Example response

{
  "data": {
    "database": "acme_corp",
    "message": "Success",
    "status": "completed",
    "tenant_id": "tenant_1234"
  },
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "collection": "team_docs",
    "database": "acme_corp",
    "deprecation": [
      {
        "deprecated": true,
        "deprecated_field": "tenant_id",
        "deprecated_since": "2.0.1",
        "message": "tenant_id is deprecated; use database instead.",
        "preferred_field": "database"
      }
    ],
    "latency_ms": 12.3,
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "source_type": "file",
    "sub_tenant_id": "sub_tenant_4567",
    "tenant_id": "tenant_1234"
  },
  "success": true
}