> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bigdata_delete_monitor

> Delete one or more search monitors you own.

## Overview

The `bigdata_delete_monitor` tool permanently deletes between 1 and 20 search monitors from your Bigdata.com account.

> [!WARNING]
>
> Deletion is permanent and cannot be undone through the MCP tools.

## When to Use

Delete Monitor is ideal for:

* **Cleaning up:** Removing monitors created for a test or a one-off question
* **Retiring monitors:** Deleting monitors that are no longer needed
* **Bulk removal:** Deleting several monitors in a single call

## How It Works

1. **List** monitors with [`bigdata_get_monitor`](https://docs.bigdata.com/mcp-reference/tools/bigdata-get-monitor) if the user has not supplied the IDs
2. **Confirm** with the user which monitors to delete, by name
3. **Call** `bigdata_delete_monitor` with the list of IDs

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `ids` | string\[] (1-20 items) | Yes | IDs of the monitors to delete. |

```json theme={null}
{"ids": ["b0253b18-0dd8-4a01-a9a4-f209bce91a26"]}
```

### Important Notes

* Every ID is read first. If any one does not exist, nothing is deleted
* Deletes then run in order. If one fails partway, the error says which IDs are already deleted, and the rest are not attempted
* A monitor with a run in progress cannot be deleted. Wait until the run finishes, then try again
* Never guess IDs. Take them from `bigdata_get_monitor`

## Data Returned

Returns the IDs that were deleted, in the same shape as the input:

| Field | Description |
| - | - |
| `ids` | IDs of the monitors that were deleted |

```json theme={null}
{"ids": ["b0253b18-0dd8-4a01-a9a4-f209bce91a26"]}
```

## Practical Tips

### Deactivate instead of deleting

To pause a monitor but keep its configuration, set `status` to `inactive` with [`bigdata_edit_monitor`](https://docs.bigdata.com/mcp-reference/tools/bigdata-edit-monitor) instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.