Update a saved query
saved_queries_updateUpdate an existing saved query's name, Boolean wording, platforms, schedule, alerts, webhook, briefing, noise presets, sentiment/insights, or active status to refine what it monitors.
Instructions
Change a saved query: its name, query, platforms, schedule, limits, volume alert (alertThreshold, null to remove it), webhook endpoint, briefing, noise presets, platformSearches (null to search every platform as planned), sentiment or insights (null to turn them off) (only the fields given), or pause or resume it with status. A new query wording is saved as a new version; matches already stored keep the version that found them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "saved_queries_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The saved query's id. | |
| name | No | A name for the query, shown in the dashboard and in alerts. | |
| noise | No | Kinds of post its runs leave out: `jobs` (job ads and job seekers' posts), `giveaways` (giveaway and contest entry posts), `crypto-spam` (crypto promotion and money scams). Checked on each post after it's found, so a run costs the same. Empty, the default, leaves everything in. | |
| query | No | The Boolean query. Check it for free first with POST /v1/query/validate. | |
| status | No | Pause or resume it. Resuming a `capped` or `broken` query tries again. | |
| syntax | No | Syntax the query is written in: `native` (Social Fetch's Boolean language), or another tool's to import: `x` (X search), `onclusive`, `talkwalker`, `brandwatch` (also Cision Social Listening) or `meltwater`. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| briefing | No | A briefing on what it found: `daily` covers the day before (UTC) and comes at 08:00 UTC; `weekly` covers Monday to Sunday and comes on Monday at 08:00 UTC. It counts the posts, the change on the period before, the stories, each platform's posts, the loudest voices and the 5 most engaged posts, is shown on the query in the Listening app, and is sent to its webhook endpoint as the `saved_query.briefing` event. Only for an active query that ran in the period without failing. Null for none, the default. | |
| insights | No | ||
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| platforms | No | Platforms to search. Empty means every platform search covers. | |
| sentiment | No | Give each new match a sentiment estimate (positive, neutral or negative), for 1 credit per 10 matches given one, on top of each run's maxCreditsPerRun but within monthlyCreditCap when one is set. Only matches given one are charged. A match keeps its sentiment: it's never estimated or charged again. Default false. | |
| alertThreshold | No | A volume alert: when a run brings the posts it found in the trailing `window` to at least `posts`, it sends the `saved_query.threshold` webhook event, at most once a window. The first run of a query or of a new wording doesn't alert (it finds the backlog). Null for none. | |
| cadenceMinutes | No | Minutes between scheduled runs, from 15 to 10080 (a week). | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| maxCreditsPerRun | No | The most one run may charge, held while it runs as with POST /v1/query/search; what isn't used is given back. | |
| monthlyCreditCap | No | The most all its runs may charge in a calendar month (UTC). Null for no cap beyond each run's. | |
| platformSearches | No | ||
| webhookEndpointId | No |