Delete a database – DELETE /v1/databases/{databaseId}

DELETE/v1/databases/{databaseId}

betaapiKeyworkspace

When to use

Permanently delete a managed database and its cluster.

For agents

Requires admin permission. Deletion is asynchronous; later reads return 404 once the database is gone.

Example

typescript

import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.databases.delete('dbas_crm123');

Response

json

{
  "data": {
    "id": "dbas_crm123",
    "workspaceId": "wksp_finance123",
    "name": "CRM",
    "key": "crm",
    "status": "deleting",
    "createdAt": "2026-09-18T12:00:00.000Z",
    "updatedAt": "2026-09-18T12:00:08.000Z"
  }
}