Pause or resume a monitor
pause_monitorPause a monitor so it makes no more scheduled runs, or resume it. Use it when the person wants a kept search or question to stop for now, or to start again. A paused monitor keeps its runs and records; nothing is deleted. Inputs: monitor_id from list_monitors. resume=true starts it again: a slot that passed while it was paused runs once, at the next tick. Effect: it answers with the monitor. A run under way finishes. Nothing is fetched and no credits are spent by pausing. Needs write access; a read-only connection is refused with code 'read_only'.
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": {
"monitor_id": "<monitor_id>"
},
"name": "pause_monitor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| resume | No | true resumes a paused monitor; default false pauses it. | |
| monitor_id | Yes | The monitor's id, from list_monitors or create_monitor. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The monitor's id, for list_monitors, pause_monitor and get_monitor_rows. | |
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| kind | No | 'search' or 'agent'. | |
| name | No | Its name; the query or the prompt unless one was given. | |
| note | No | What happens next, or what was left out. | |
| rows | No | When it follows its answer as records: {path, key, confirmAfter}. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| budget | No | {perRun, perMonth} in credits; 0 is no cap. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| status | No | 'active' or 'paused'. On an error, the HTTP status code. | |
| lastRun | No | Its latest run: {status, changed, summary, credits, refId}; refId is the search or agent run it made. | |
| request | No | The search or agent request it runs, in the API's names. | |
| schedule | No | 'hourly', 'daily' or 'weekly'. | |
| nextRunAt | No | When it runs next, ISO 8601; null while paused. | |
| spentThisMonth | No | What its runs cost this calendar month (UTC), in credits. |