Tools
update_view
Changes a saved View: its name, predicate, delivery, destinations, paused state or Digest.
When to use it
- You want to rename a View, change its predicate, pause or resume it, or change how its Matches reach you.
- You want a View to deliver to one more destination, change how often it delivers there, or stop delivering there:
attach_destinationordetach_destination. - For a new View, use
create_view. To remove one for good, usedelete_view. - It replaces
set_view_targetandremove_view_target, whose names still answer: see Old names.
Inputs
view_id(uuid, required): The View to change, fromlist_views. Only the fields you pass change; the rest stay as they were.name(string): The View's new name. Up to 120 characters.predicate(object): A new predicate that replaces the old one whole. A new predicate also changes what the next Issue holds, and that Issue's New and Gone count against the previous Issue, so a broad edit shows up there.enabled(boolean):falsepauses the View,trueresumes it.channels(array of strings): Replaces where Matches go:emailsends them to your account's email address, andwebhooksends them to the alert destinations attached to this View. One ofemail,webhook.max_firings_per_eval(integer): The most events the View can match each time it runs. The events kept past the cap are not the largest moves. From 1 to 500.apply_economic_floor(boolean): Leave out thin events, with few listings or a low median price. Setfalseto match every event.delivery_target_id(uuid): Attach an alert destination, fromlist_destinations, that gets each Match the instant it fires.nulldetaches it; leave it out to keep it. A newly attached destination gets only new Matches, not the ones the View already recorded.notification_cadence(string): How often Matches may leave as email:immediatesends each one,hourlyanddailygather them, andoffrecords them with no email.nullresets it to your account's default. Destinations ignore it: they get each Match the instant it fires. One ofimmediate,hourly,daily,off.notification_mode(string): How email carries the Matches:instantsends one email per Match,batchedholds them and sends them together in one email at the pacenotification_cadencesets, andmutedrecords them and sends no email.nullfalls back to whatnotification_cadencesets. Sendbatched: until 2026-11-30 Ticker also acceptsdigest, its old name, and saves it asbatched; a response always saysbatched. One ofinstant,batched,muted,digest.tags(array of strings): Replaces the View's labels;[]clears them. Labels group and filter Views in the app and never change what the View matches or where it sends. Up to 5 items.color(string): The accent color the app shows on the View;nullclears it. Cosmetic only. One ofred,orange,amber,green,teal,blue,violet,pink.digest(object): Changes the View's Digest, its whole table sent at an hour you pick: pass any ofenabled,hour,formats,destination_ids,sections,extra_columns,table_columnsandcolumns, ascreate_viewdescribes them. Fields you leave out stay as they were;[]clearsdestination_idsorextra_columns, and restores the defaulttable_columns. A call with onlydigestchanges nothing else on the View. A Digest is notnotification_modebatched.parking(string): Parking passes sold as their own event:hide(the default) leaves them out,onlyreturns parking alone,includereturns parking beside every other event. Leave it out to keep the View's choice. One ofhide,include,only.attach_destination(object): Deliver this View's Matches to one more destination, fromlist_destinations:{ "delivery_target_id": "…", "cadence": "instant" }.cadenceisinstant,hourlyordaily, for this View and this destination. Attaching one the View has already changes its cadence. A newly attached destination gets only new Matches; email is not touched.detach_destination(uuid): Stop this View delivering to this destination, by its id. The destination keeps serving other Views, and a View left with none goes back to email alone.
Examples
Pause my Zach Bryan View.
{ "view_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "enabled": false }Send my Knicks View to my Slack channel too, gathered into one post.
{
"view_id": "2f1d7a4e-8c3b-4b9e-a6d5-0e9f8c7b6a51",
"attach_destination": {
"delivery_target_id": "9b3e2d1c-4a5f-4c8e-b7d6-1a2b3c4d5e6f",
"cadence": "daily"
}
}Turn on the Digest for my View at 7 a.m. with only Movers and New, and post it to my Slack channel too.
{
"view_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"digest": {
"enabled": true,
"hour": 7,
"sections": ["movers", "new"],
"destination_ids": ["9b3e2d1c-4a5f-4c8e-b7d6-1a2b3c4d5e6f"]
}
}What comes back
- The View as saved:
id,name,predicate,enabled,channels,notification_mode,notification_cadence,tagsandcolor. lockwhen the View filters on a column your plan does not include: it sends no alerts until the account is onlock.required_tieragain or thelock.columnsleave its filter.destinationswhen you attached or detached one: every destination the View delivers to now, with itscadence. A destination's posting URL is never returned.digestwhen you passed one: the setting as saved, withlivetruewhen it is on and sending.- An invalid predicate is refused with a message that names the problem.
Limits and quota
- Changes or deletes something you own.
- Reaches beyond Ticker: it can send alerts or read the web.
- Each call spends one MCP request.
- The Digest change is made first. Turning a Digest on past your plan's Digest count is refused with the plan that carries more, and the refusal changes nothing.
- A predicate that names a column your plan does not include is refused. A destination that is not yours, or one that cannot take a Digest, is refused.
- On an organization, only a View's creator or the organization's owner can change it.
- A View past your plan's Views and stars count answers not found until the plan holds more.