Update Monitor Tool
update-monitorUpdate a monitor by ID. Supports HTTP, keyword, TCP, ping, and DNS monitors. Requires Full Access MCP token and eligible paid plan.
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": "update-monitor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL to monitor for http and keyword monitors | |
| host | No | Hostname or IP for tcp, ping, and dns monitors | |
| name | No | Monitor display name | |
| port | No | TCP port number 1-65535 for tcp monitors | |
| type | No | Type of check: http, keyword, tcp, ping, dns, or heartbeat (Pro+, passive inbound check-in) | |
| keyword | No | Keyword to search for keyword monitors | |
| timeout | No | Response timeout in seconds: 5, 10, or 15 | |
| monitor_id | Yes | The UUID of the monitor to update | |
| monitor_ssl | No | Enable SSL certificate monitoring for http/keyword monitors | |
| keyword_type | No | Alert when keyword exists or does not exist | |
| notify_uptime | No | Enable uptime/recovery notifications | |
| check_interval | No | Frequency of checks in seconds | |
| monitor_domain | No | Enable domain expiry monitoring for http/keyword monitors | |
| alert_threshold | No | Consecutive failures before alerting: 1, 2, 3, or 5 | |
| dns_record_type | No | DNS record type for dns monitors | |
| monitor_consent | No | Enable or disable the weekly Consent Scan, which records the cookies the page sets before and after consent (http/keyword only, counts toward the plan's Consent Scan limit). Reports observations, never a compliance verdict. | |
| request_headers | No | Optional HTTP request headers as objects with name and value | |
| dns_expected_value | No | Expected DNS value for hijacking detection | |
| monitor_page_speed | No | Enable Page Speed monitoring when allowed by plan | |
| pinned_region_code | No | Location this monitor is checked from. Use list-check-regions for valid values; omit or send an empty string for automatic selection. | |
| private_location_id | No | UUID of one of your own Private Locations to check this monitor from instead of the Baromio fleet. Use list-private-locations for valid values. Only http, keyword, and tcp types are eligible. | |
| accepted_status_codes | No | HTTP monitors only: status codes 400-599 (at most 10) to count as up in addition to 200-399, for a URL that answers 401, 404 or 503 on purpose. Send an empty array to clear the list. Not available for keyword monitors. |