Update Saved Event Filter (View)
update_viewDestructive
Changes a View that exists: name, predicate, channels, email mode, alert destinations, paused state or Digest. Only the fields passed change, and a change can start, stop or redirect its alerts: enabled true resumes them, and attach_destination and detach_destination add or remove an alert destination. Use it when the person asks to edit, pause or resume a saved View. create_view makes a new one; delete_view removes one permanently.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"view_id": "<view_id>"
},
"name": "update_view"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A new name, up to 120 characters. | |
| tags | No | Replace this View's organization tags (max 5; [] clears them). Omit to leave unchanged. Tags only group/filter Views in the app; they never change matching or delivery. | |
| color | No | Set the View's accent color (red, orange, amber, green, teal, blue, violet, pink). Pass null to clear; omit to leave unchanged. Cosmetic only. | |
| digest | No | The View's Digest: each Issue is the View's events with Movers, New and Gone against the previous Issue. Only the fields you pass change. Turning it on past the plan's Digest count is refused with the plan that carries more. | |
| enabled | No | Set false to pause the View, true to resume. | |
| parking | No | Parking events: a parking pass that is its own event (sub_category_id 75 or 'Parking' in the name). `hide` (the default) leaves them out; `only` returns parking alone; `include` returns parking beside every other event. Set `only` when the user asks for parking, `include` when they want both; leave it at `hide` otherwise. Omit to leave the View's choice unchanged. | |
| view_id | Yes | The View to update (from list_views). | |
| channels | No | Replacement delivery channels, at least one, as create_view takes them. Omit to leave them unchanged. | |
| predicate | No | Replacement predicate, the grammar create_view's predicate takes. Omit to leave the predicate unchanged. | |
| notification_mode | No | Per-alert EMAIL delivery mode: 'instant' (email each match), 'batched' (the Matches wait and go out together in one email, at the pace notification_cadence sets: `hourly` or `daily`; with `off` it is saved as 'muted'), or 'muted' (Matches recorded, never emailed). 'instant' and 'muted' override notification_cadence. 'digest' is the old name of 'batched', accepted until 2026-11-30 and stored as 'batched'. Alert destinations are unaffected: they always deliver instantly. Pass null to fall back to the cadence-derived behavior; omit to leave unchanged. | |
| attach_destination | No | Deliver this View's Matches to one more destination, or change the cadence of one it has. A fresh attach starts with the next Match. Email is not touched. | |
| delivery_target_id | No | Attach an alert destination (id from list_destinations; new destinations are added in the Ticker web app under Settings) so this alert also delivers there the moment it fires. Pass null to DETACH and go email-only; omit to leave the destination unchanged. | |
| detach_destination | No | Stop this View delivering to this destination. The destination keeps serving other Views, and a View left with none goes back to email alone. | |
| apply_economic_floor | No | Whether the predicate is AND-ed with the economic floor (listings_current >= 25 AND median_price_current >= 40). Omit to leave it unchanged. | |
| max_firings_per_eval | No | Most events the View can match per evaluation, 1 to 500. Omit to leave it unchanged. | |
| notification_cadence | No | How often this alert's Matches may leave as EMAIL: `immediate` (each match), `hourly`, `daily` (batched), or `off` (Matches recorded but never emailed; a 'batched' alert with `off` is saved as 'muted'). Only paces EMAIL; an attached alert destination always delivers the instant a Match fires, regardless of this. Pass null to reset to the account default; omit to leave unchanged. |