---
title: "Edit a monitor"
method: PATCH
path: "/monitors/{monitorId}"
tags: ["monitors"]
---

# Edit a monitor

`PATCH /monitors/{monitorId}`

## Path parameters

- `monitorId` string, required

## Request body

- object
  - `name` string
  - `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port' | 'game' | 'grpc' | 'websocket' | 'dns' | 'unknown'
  - `url` string
  - `statusWindowSize` number
  - `statusWindowThreshold` number
  - `description` union
    - string
    - ''
  - `interval` number
  - `notifications` string[]
  - `tags` string[]
  - `customUpCodes` number[]
  - `secret` string
  - `ignoreTlsErrors` boolean
  - `useAdvancedMatching` boolean
  - `jsonPath` union
    - string
    - ''
  - `expectedValue` union
    - string
    - ''
  - `matchMethod` union
    - 'equal' | 'include' | 'regex'
    - ''
  - `port` number
  - `cpuAlertThreshold` number
  - `memoryAlertThreshold` number
  - `diskAlertThreshold` number
  - `tempAlertThreshold` number
  - `gameId` union
    - string
    - ''
  - `grpcServiceName` union
    - string
    - ''
  - `strategy` 'desktop' | 'mobile'
  - `selectedDisks` string[]
  - `group` union
    - string
    - unknown
    - ''
  - `geoCheckEnabled` boolean
  - `geoCheckLocations` string[]
  - `geoCheckInterval` number
  - `dnsServer` string
  - `dnsRecordType` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS'

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` Monitor, required
    - `_id` string, required
    - `name` string, required
    - `description` string
    - `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port' | 'game' | 'grpc' | 'websocket' | 'dns' | 'unknown', required
    - `url` string, required
    - `port` number
    - `isActive` boolean, required
    - `interval` number, required
    - `status` 'up' | 'down' | 'paused' | 'initializing' | 'maintenance' | 'breached', required
    - `statusWindowSize` number, required
    - `statusWindowThreshold` number, required
    - `ignoreTlsErrors` boolean, required
    - `useAdvancedMatching` boolean, required
    - `jsonPath` string
    - `expectedValue` string
    - `matchMethod` 'equal' | 'include' | 'regex'
    - `notifications` string[], required
    - `tags` string[], required
    - `customUpCodes` number[]
    - `secret` string
    - `cpuAlertThreshold` number, required
    - `memoryAlertThreshold` number, required
    - `diskAlertThreshold` number, required
    - `tempAlertThreshold` number, required
    - `selectedDisks` string[], required
    - `gameId` string
    - `grpcServiceName` string
    - `group` string, nullable
    - `geoCheckEnabled` boolean, required
    - `geoCheckLocations` string[], required
    - `geoCheckInterval` number, required
    - `dnsServer` string
    - `dnsRecordType` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS'
    - `teamId` string, required
    - `userId` string, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

## Changes

- **2026-06-09** `ca827e5b975f` — 2 info
  - added the new optional request property `customUpCodes`
  - added the optional property `data/customUpCodes` to the response with the `200` status
- **2026-05-27** `dd1708803c7c` — 2 info
  - added the new optional request property `tags`
  - added the required property `data/tags` to the response with the `200` status
- **2026-05-11** `59d86e7d3831` — 1 warning, 6 info
  - added the new `dns` enum value to the `data/type` response property for the response status `200`
  - added the new optional request property `dnsRecordType`
  - added the new optional request property `dnsServer`
  - added the new optional request property `strategy`
  - …3 more
- **2026-05-01** `39082d385dda` — 19 breaking, 3 warning, 58 info
  - for the `path` request parameter `monitorId`, the minLength was increased from `0` to `1`
  - the request property `group` became not nullable
  - removed the enum value `` of the request property `matchMethod`
  - removed the enum value `africa` of the request property `geoCheckLocations/items/`
  - …76 more
- **2026-03-18** `143d311a335a` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/monitors/:monitorId/patch.md)

---

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