---
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"
}
```