Skip to main content
Update an existing alert. This is a mutating tool. Only the fields you pass change; everything you omit is left untouched. The entities and notifications lists, when provided, replace the whole set — pass the complete new list, not a delta. Entities are passed as slugs from the resolve tools, exactly as in particle_alert_create; each is re-resolved to its (entity_type, entity_id) internally. Use is_active to pause or resume an alert without deleting it. An alert’s kind is fixed at creation — to watch for a different signal (mention vs. speaker appearance), create a new alert.

​
Inputs

FieldTypeRequiredDefaultDescription
alert_idstringyes—Alert id to update.
titlestringnounchangedNew title.
descriptionstringnounchangedNew description.
delivery_cadenceenumnounchangedNew delivery cadence: REALTIME, DAILY, or WEEKLY.
is_activebooleannounchangedPause (false) or resume (true) the alert.
entitiesarray of stringsnounchangedReplacement watch list as entity slugs (from the resolve tools). When provided, replaces the entire existing set; omit to leave entities unchanged.
notificationsarray of stringsnounchangedReplacement notification emails. When provided, replaces the entire existing set; omit to leave them unchanged.

​
Output

A markdown document rendering the updated alert’s full configuration — the same shape returned by particle_alert_create and particle_alert_get: title H2, **ID:**, **Kind:**, **Delivery:**, **Status:**, optional **Description:**, a ### Watching (N) entity list, and a **Notify:** row. Passing output_format: "json" returns the same fields as compact JSON.

​
Example

# Pause an alert without deleting it.
Agent calls: particle_alert_update { "alert_id": "dKxN6Ry2mL9pJ5qW", "is_active": false }

# Switch to a weekly digest and swap in a new watch list.
Agent calls: particle_company_resolve { "ticker": "NVDA" }
            → reads "- **Slug:**" row → "nvidia"

Agent calls: particle_alert_update {
  "alert_id": "dKxN6Ry2mL9pJ5qW",
  "delivery_cadence": "WEEKLY",
  "entities": ["nvidia", "sam-altman"]
}