delete_dive

Public Preview

Dives are currently in public preview and functionality is subject to change.

Delete a Dive 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 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

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

Example Usage

Delete a Dive:

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:

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

Success Response Example

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

Error Response Example

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