manage_watch
Manage the lifecycle of an existing watch. Paused watches stop polling but retain their configuration and event history. Deleted watches are removed permanently.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
| watchId | string | Yes | Watch ID to manage |
| action | string | Yes | pause, resume, or delete |
Example
Section titled “Example”Request
Section titled “Request”{ "name": "manage_watch", "arguments": { "watchId": "w_abc123def456", "action": "pause" }}Response
Section titled “Response”{ "success": true, "message": "Watch w_abc123def456 paused."}- Paused watches retain their configuration and event history. Use
resumeto reactivate polling. - Deleted watches are permanent — all configuration and history is removed.
- Returns
success: falseif the watch ID is not found.
Related Tools
Section titled “Related Tools”- list_watches — find watch IDs
- create_watch — create a replacement watch
- get_watch_events — review events before deleting