TickerDocs
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_destination or detach_destination.
  • For a new View, use create_view. To remove one for good, use delete_view.
  • It replaces set_view_target and remove_view_target, whose names still answer: see Old names.

Inputs

  • view_id (uuid, required): The View to change, from list_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): false pauses the View, true resumes it.
  • channels (array of strings): Replaces where Matches go: email sends them to your account's email address, and webhook sends them to the alert destinations attached to this View. One of email, 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. Set false to match every event.
  • delivery_target_id (uuid): Attach an alert destination, from list_destinations, that gets each Match the instant it fires. null detaches 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: immediate sends each one, hourly and daily gather them, and off records them with no email. null resets it to your account's default. Destinations ignore it: they get each Match the instant it fires. One of immediate, hourly, daily, off.
  • notification_mode (string): How email carries the Matches: instant sends one email per Match, batched holds them and sends them together in one email at the pace notification_cadence sets, and muted records them and sends no email. null falls back to what notification_cadence sets. Send batched: until 2026-11-30 Ticker also accepts digest, its old name, and saves it as batched; a response always says batched. One of instant, 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; null clears it. Cosmetic only. One of red, 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 of enabled, hour, formats, destination_ids, sections, extra_columns, table_columns and columns, as create_view describes them. Fields you leave out stay as they were; [] clears destination_ids or extra_columns, and restores the default table_columns. A call with only digest changes nothing else on the View. A Digest is not notification_mode batched.
  • parking (string): Parking passes sold as their own event: hide (the default) leaves them out, only returns parking alone, include returns parking beside every other event. Leave it out to keep the View's choice. One of hide, include, only.
  • attach_destination (object): Deliver this View's Matches to one more destination, from list_destinations: { "delivery_target_id": "…", "cadence": "instant" }. cadence is instant, hourly or daily, 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, tags and color.
  • lock when the View filters on a column your plan does not include: it sends no alerts until the account is on lock.required_tier again or the lock.columns leave its filter.
  • destinations when you attached or detached one: every destination the View delivers to now, with its cadence. A destination's posting URL is never returned.
  • digest when you passed one: the setting as saved, with live true when 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.

On this page