New: The AI Analytics Eval Field GuideGet the Free Playbook

Skip to main content

delete_dive

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

ParameterTypeRequiredDescription
idstringYesThe 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"
}