---
sidebar_position: 15
title: delete_dive
description: Permanently delete a Dive by ID
feature_stage: preview
---

Delete a [Dive](/docs/key-tasks/ai-and-motherduck/dives) by ID. This action is permanent and cannot be undone.

## Description

The `delete_dive` tool permanently removes a Dive from your MotherDuck workspace. Once deleted, the Dive cannot be recovered.

Use [`list_dives`](../list-dives) to find the Dive ID before deleting.

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the Dive to delete |

## Output Schema

```json
{
  "success": boolean,
  "message": string,             // Status message (on success)
  "error": string                // Error message (on failure)
}
```

## Example Usage

**Delete a Dive:**

```text
Delete the old revenue Dive I no longer need
```

The AI assistant will call `list_dives` to find the Dive, confirm with the user, then call `delete_dive`:

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## Success Response Example

```json
{
  "success": true,
  "message": "Dive 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' deleted successfully."
}
```

## Error Response Example

```json
{
  "success": false,
  "error": "Dive with id 'invalid-uuid' not found"
}
```


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `POST https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

Payload:

```json
{
  "page_path": "/sql-reference/mcp/delete-dive/",
  "page_title": "delete_dive",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed payloads, and `429` when rate-limited.