Skip to main content
Delete an alert. This is a destructive tool, but a soft delete: the alert stops producing matches and disappears from particle_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 with is_active=false.

​
Inputs

FieldTypeRequiredDefaultDescription
alert_idstringyes—Alert id to delete.

​
Output

A short markdown confirmation: 
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

Agent calls: particle_alert_delete { "alert_id": "dKxN6Ry2mL9pJ5qW" }