Watches, write

Update watch

Change a watch: its terms, its platforms, its label, its group, its reply notes or its posts a day. Send only what changes. The kind never moves — a topic is not a mention with different words, so add a new watch for that.

write

MCP

Tool nameupdate_watch
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_watch",
    "arguments": {
      "project_id": "<uuid>",
      "watch_id": "<uuid>"
    }
  }
}

Input

project_idrequireduuid
watch_idrequireduuid

The watch's own id, from list_watches.

queryarray of string

The terms, exactly as the dialog takes them: one phrase for a topic, the names people use for you on a mention watch, handles without the @ on an account watch. A topic holds one term; several terms make several topic watches.

platformsarray of x | hn | youtube | bluesky | reddit

Where the watch runs, one or more of x, hn, youtube, bluesky, reddit. Each is charged at its own blip rate; Reddit is stored and never polled.

labelstring

What to call it. Empty names each watch by its own term.

group_iduuid | null

A folder to move it into, or null to take it out of every group.

intent_notesarray of { intent, note } | null

How to reply per intent, up to 12 rows of { intent, note }. Ignored on an account watch, which keeps none.

posts_per_dayinteger | null

X account watches only: posts a day Sonket may be billed for from them. Null is 5, at most 50.

Returns

The watch as saved, every field, so a caller sees what the merge left.