Update Saved View
update_viewChanges a saved View: name, predicate, channels, email mode, destinations, paused state or Digest. Only the fields passed change; attach_destination and detach_destination change where it delivers. Use create_view for a new View, and delete_view to remove one for good. Replaces set_view_target and remove_view_target.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| 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. | |
| view_id | Yes | The View to update (from list_views). | |
| channels | No | ||
| 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`), 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 | ||
| max_firings_per_eval | No | ||
| 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). 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. |