Update Watch
update_watchUpdate an existing watch's name, novelty floor, or filter criteria. Replacing criteria clears pending hits to prevent stale deliveries; use preview_watch to tune new criteria first.
Instructions
Update an existing watch in place — rename, change novelty_min, or RETARGET its structured filter criteria. MUTATES. Address by watch_id OR name. Changing criteria replaces the definition and clears the watch's pending hits (so stale matches don't deliver); the next daily eval repopulates. Structured watches rank by 'rising' (forecasted breakout impact) by default, and tighten with min_impact_pct for an anti-noise watch that surfaces only the breakout papers in your niche. Tune the new criteria with preview_watch first. Requires SF_API_KEY.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Find the watch by its current name. Provide this OR watch_id. | |
| watch_id | No | Find the watch by UUID. Provide this OR name. | |
| new_name | No | Rename the watch. | |
| novelty_min | No | New novelty floor (0..1). | |
| criteria | No | Replace the watch's filter (becomes kind='filter'). Clears pending hits. | |
| recency_days | No | Window for the new criteria. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | True when the operation succeeded. | |
| message | No | Human-readable summary of the outcome. | |
| action | No | Machine label: saved | no_change | removed | liked | created | updated | deleted. | |
| arxiv_id | No | ||
| collection | No | The created/affected collection, when applicable. | |
| watch | No | The created/affected watch, when applicable. |