---
title: "Update a monitor"
method: PUT
path: "/v1/monitors/{uuid}"
tags: ["Monitors"]
---

# Update a monitor

`PUT /v1/monitors/{uuid}`

Update an existing monitor's configuration.

## Path parameters

- `uuid` string, required

## Request body

- MonitorCreate
  - `name` string, required
  - `url` string, required
  - `protocol` 'http' | 'port' | 'icmp'
  - `http_method` 'GET' | 'POST' | 'PUT' | 'HEAD' | 'DELETE' | 'PATCH' | 'OPTIONS'
  - `check_frequency` 10 | 20 | 30 | 60 | 120 | 180 | 300 | 600 | 1800 | 3600 | 21600 | 43200 | 86400
  - `regions` string[]
  - `expected_status_code` string — Use "2xx" for 200-299, "1xx-3xx" for 100-399, or a specific code like "200"
  - `required_keyword` string
  - `follow_redirects` boolean
  - `port` integer
  - `paused` boolean
  - `alerts_wait` -1 | 0 | 1 | 2 | 3 | 5 | 10 | 30 | 60
  - `request_body` string
  - `request_headers` object[]
    - `name` string
    - `value` string
  - `escalation_policy` string — Policy UUID or 'none' to unlink

## Response `200`

Monitor updated

- Monitor
  - `uuid` string
  - `name` string
  - `url` string
  - `protocol` 'http' | 'port' | 'icmp'
  - `http_method` 'GET' | 'POST' | 'PUT' | 'HEAD' | 'DELETE' | 'PATCH' | 'OPTIONS'
  - `check_frequency` integer — Check interval in seconds
  - `regions` string[]
  - `status` 'up' | 'down'
  - `paused` boolean
  - `expected_status_code` string — Use "2xx" for 200-299, "1xx-3xx" for 100-399, or a specific code like "200"
  - `required_keyword` string
  - `follow_redirects` boolean
  - `port` integer, nullable
  - `ssl_expiration` integer — Days until SSL expiration
  - `alerts_wait` integer — Minutes before alerting (-1 to disable)
  - `escalation_policy` object, nullable
    - `uuid` string
    - `name` string

---

[API](https://skmtc.dev/hyperping/apis/hyperping-api.md) · [All operations](https://skmtc.dev/hyperping/apis/hyperping-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperping/hyperping-api/revisions/953c52272fa8/schema)