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

# particle_alert_delete

> Delete an alert (soft delete; past matches and deliveries are retained).

Delete an alert. This is a **destructive** tool, but a soft delete: the alert stops producing matches and disappears from [`particle_alert_list`](/mcp/tools/alerts/alert-list), while its past matches and deliveries are retained for audit. A deleted alert also frees its slot against your plan's alert allowance.

To pause an alert instead of removing it — keeping it in the list and resumable later — use [`particle_alert_update`](/mcp/tools/alerts/alert-update) with `is_active=false`.

## Inputs

| Field      | Type   | Required | Default | Description         |
| ---------- | ------ | -------- | ------- | ------------------- |
| `alert_id` | string | yes      | —       | Alert id to delete. |

## Output

A short markdown confirmation:

```markdown theme={"dark"}
Deleted alert `dKxN6Ry2mL9pJ5qW`. Existing matches and deliveries are retained for audit; no new matches will be produced.
```

Passing `output_format: "json"` returns `id` and `deleted` as compact JSON.

## Example

```text theme={"dark"}
Agent calls: particle_alert_delete { "alert_id": "dKxN6Ry2mL9pJ5qW" }
```

## Related

* REST equivalent: [`DELETE /v1/alerts/{id}`](/api-reference/alerts/delete-an-alert).
* To pause an alert instead of deleting it, use [`particle_alert_update`](/mcp/tools/alerts/alert-update) with `is_active=false`.
* List your remaining alerts with [`particle_alert_list`](/mcp/tools/alerts/alert-list).