---
title: "Changes to Edit a monitor (admin/superadmin)"
method: PATCH
path: "/monitors/{monitorId}"
---

# Changes to Edit a monitor (admin/superadmin)

`PATCH /monitors/{monitorId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 17 of 82 revisions.

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 7 info
- **2026-10-01** `5247c2a7e648`: 1 warning
- **2026-10-01** `9b162bd63ecf`: 8 breaking, 16 info
- **2026-09-23** `f0efb54cd379`: 4 info
- **2026-09-12** `18b49d155064`: 2 warning, 8 info
- **2026-08-28** `a9ac59e12c59`: 2 info
- **2026-08-25** `1f334de2d559`: 4 info
- **2026-06-24** `648dc5ab4761`: 3 info
- **2026-06-09** `ca827e5b975f`: 2 info
- **2026-05-27** `dd1708803c7c`: 2 info
- **2026-05-11** `59d86e7d3831`: 1 warning, 6 info
- **2026-05-01** `39082d385dda`: 19 breaking, 3 warning, 58 info
- **2026-03-18** `143d311a335a`: 1 info
- **2026-03-18** `cd5518087304`: 1 breaking
- **2026-03-18** `d8f65feee904`: 3 warning, 23 info
- **2026-03-18** `d213b278315e`: 1 info
- **2025-04-20** `b97ec6888b3c`: 1 breaking

## Changes

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 7 info
  - removed the required property `success` from the response with the `401` status
  - removed the required property `success` from the response with the `403` status
  - removed the required property `success` from the response with the `500` status
  - removed the optional property `data` from the response with the `401` status
  - removed the optional property `data` from the response with the `403` status
  - removed the optional property `data` from the response with the `500` status
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - added the non-success response with the status `429`
  - added the required property `status` to the response with the `401` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `500` status
- **2026-10-01** `5247c2a7e648`: 1 warning
  - removed the optional property `data/dockerTlsKey` from the response with the `200` status
- **2026-10-01** `9b162bd63ecf`: 8 breaking, 16 info
  - the response property `data/dockerAlertOnStopped` became optional for the status `200`
  - the response property `data/dockerAlertOnUnhealthy` became optional for the status `200`
  - the response property `data/dockerLogsEnabled` became optional for the status `200`
  - the response property `data/geoCheckEnabled` became optional for the status `200`
  - the response property `data/geoCheckInterval` became optional for the status `200`
  - the response property `data/geoCheckLocations` became optional for the status `200`
  - the `data/matchMethod` response's property type changed from `string` to no type for status `200`
  - removed the required property `data/_id` from the response with the `200` status
  - added the optional property `data/dockerTlsKey` to the response with the `200` status
  - added the optional property `data/strategy` to the response with the `200` status
  - added the optional property `data/uptimePercentage` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `data/matchMethod` response property `anyOf` list for the response status `200`
  - the response property `data/customUpCodes` became required for the status `200`
  - the response property `data/group` became required for the status `200`
  - removed the `equal` enum value from the `data/matchMethod` response property for the response status `200`
  - removed the `include` enum value from the `data/matchMethod` response property for the response status `200`
  - removed the `regex` enum value from the `data/matchMethod` response property for the response status `200`
  - added the required property `data/cpuAlertCounter` to the response with the `200` status
  - added the required property `data/diskAlertCounter` to the response with the `200` status
  - added the required property `data/id` to the response with the `200` status
  - added the required property `data/memoryAlertCounter` to the response with the `200` status
  - added the required property `data/recentChecks` to the response with the `200` status
  - added the required property `data/statusWindow` to the response with the `200` status
  - added the required property `data/tempAlertCounter` to the response with the `200` status
- **2026-09-23** `f0efb54cd379`: 4 info
  - added the new optional request property `dockerAlertOnStopped`
  - added the new optional request property `dockerAlertOnUnhealthy`
  - added the required property `data/dockerAlertOnStopped` to the response with the `200` status
  - added the required property `data/dockerAlertOnUnhealthy` to the response with the `200` status
- **2026-09-12** `18b49d155064`: 2 warning, 8 info
  - removed the request property `sshPrivateKey`
  - removed the optional property `data/sshPrivateKey` from the response with the `200` status
  - added the new optional request property `dockerLogsEnabled`
  - added the new optional request property `dockerTlsCa`
  - added the new optional request property `dockerTlsCert`
  - added the new optional request property `dockerTlsKey`
  - added the optional property `data/dockerTlsCa` to the response with the `200` status
  - added the optional property `data/dockerTlsCert` to the response with the `200` status
  - added the optional property `data/dockerTlsKeySet` to the response with the `200` status
  - added the required property `data/dockerLogsEnabled` to the response with the `200` status
- **2026-08-28** `a9ac59e12c59`: 2 info
  - added the new optional request property `sshPrivateKey`
  - added the optional property `data/sshPrivateKey` to the response with the `200` status
- **2026-08-25** `1f334de2d559`: 4 info
  - added the new optional request property `proxyId`
  - added the new optional request property `proxyMode`
  - added the optional property `data/proxyId` to the response with the `200` status
  - added the required property `data/proxyMode` to the response with the `200` status
- **2026-06-24** `648dc5ab4761`: 3 info
  - added the new optional request property `method`
  - added the required property `data/lastEvaluatedAt` to the response with the `200` status
  - added the required property `data/method` to the response with the `200` status
- **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`
  - added the new `dns` enum value to the request property `type`
  - added the optional property `data/dnsRecordType` to the response with the `200` status
  - added the optional property `data/dnsServer` to the response with the `200` status
- **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/`
  - removed the enum value `asia` of the request property `geoCheckLocations/items/`
  - removed the enum value `equal` of the request property `matchMethod`
  - removed the enum value `europe` of the request property `geoCheckLocations/items/`
  - removed the enum value `include` of the request property `matchMethod`
  - removed the enum value `northAmerica` of the request property `geoCheckLocations/items/`
  - removed the enum value `oceania` of the request property `geoCheckLocations/items/`
  - removed the enum value `regex` of the request property `matchMethod`
  - removed the enum value `southAmerica` of the request property `geoCheckLocations/items/`
  - the `description` request property type changed from `string` to no type
  - the `expectedValue` request property type changed from `string` to no type
  - the `gameId` request property type changed from `string` to no type
  - the `group` request property type changed from `string` to no type
  - the `grpcServiceName` request property type changed from `string` to no type
  - the `jsonPath` request property type changed from `string` to no type
  - the `matchMethod` request property type changed from `string` to no type
  - removed the optional property `details` from the response with the `500` status
  - added the new `false` enum value to the `success` response property for the response status `500`
  - added the new `true` enum value to the `success` response property for the response status `200`
  - request body became optional
  - added `subschema #1, subschema #2` to the `description` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `expectedValue` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `gameId` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `grpcServiceName` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `jsonPath` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `matchMethod` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `group` request property `anyOf` list
  - added the new `AF` enum value to the request property `geoCheckLocations/items/`
  - added the new `AS` enum value to the request property `geoCheckLocations/items/`
  - added the new `EU` enum value to the request property `geoCheckLocations/items/`
  - added the new `NA` enum value to the request property `geoCheckLocations/items/`
  - added the new `OC` enum value to the request property `geoCheckLocations/items/`
  - added the new `SA` enum value to the request property `geoCheckLocations/items/`
  - the `geoCheckInterval` request property type was generalized from `integer` to `number`
  - the `interval` request property type was generalized from `integer` to `number`
  - the `port` request property type was generalized from `integer` to `number`
  - the `statusWindowSize` request property type was generalized from `integer` to `number`
  - …40 more
- **2026-03-18** `143d311a335a`: 1 info
  - endpoint added
- **2026-03-18** `cd5518087304`: 1 breaking
  - api removed without deprecation
- **2026-03-18** `d8f65feee904`: 3 warning, 23 info
  - removed the request property `assertions`
  - removed the request property `httpOptions`
  - removed the request property `isActive`
  - added the new optional request property `cpuAlertThreshold`
  - added the new optional request property `diskAlertThreshold`
  - added the new optional request property `expectedValue`
  - added the new optional request property `gameId`
  - added the new optional request property `geoCheckEnabled`
  - added the new optional request property `geoCheckInterval`
  - added the new optional request property `geoCheckLocations`
  - added the new optional request property `group`
  - added the new optional request property `grpcServiceName`
  - added the new optional request property `ignoreTlsErrors`
  - added the new optional request property `jsonPath`
  - added the new optional request property `matchMethod`
  - added the new optional request property `memoryAlertThreshold`
  - added the new optional request property `port`
  - added the new optional request property `secret`
  - added the new optional request property `selectedDisks`
  - added the new optional request property `statusWindowSize`
  - added the new optional request property `statusWindowThreshold`
  - added the new optional request property `tempAlertThreshold`
  - added the new optional request property `type`
  - added the new optional request property `url`
  - added the new optional request property `useAdvancedMatching`
  - the `name` request property's minLength was decreased from `1` to `0`
- **2026-03-18** `d213b278315e`: 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c`: 1 breaking
  - api removed without deprecation

---

[Operation](https://skmtc.dev/bluewave-labs/apis/checkmate-api/docs/monitors/:monitorId/patch.md) - [API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [Page](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/monitors/:monitorId/patch)
