---
title: "Changes to Create one or more maintenance windows (admin/superadmin)"
method: POST
path: "/maintenance-window"
---

# Changes to Create one or more maintenance windows (admin/superadmin)

`POST /maintenance-window`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 82 revisions.

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 5 info
- **2026-10-01** `1a65d51758bb`: 1 warning
- **2026-09-28** `6c9c6730f549`: 1 info
- **2026-05-01** `39082d385dda`: 9 breaking, 5 warning, 8 info
- **2025-08-11** `db719f9e3d34`: 1 info
- **2025-04-20** `b97ec6888b3c`: 1 breaking

## Changes

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 5 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 `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** `1a65d51758bb`: 1 warning
  - removed the optional property `data` from the response with the `200` status
- **2026-09-28** `6c9c6730f549`: 1 info
  - the `active` request property default value `true` was added
- **2026-05-01** `39082d385dda`: 9 breaking, 5 warning, 8 info
  - added the new required request property `duration`
  - added the new required request property `durationUnit`
  - added the new required request property `end`
  - added the new required request property `repeat`
  - added the new required request property `start`
  - the request property `monitors` became required
  - the `monitors` request property's minItems was increased to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - removed the success response with the status `201`
  - removed the request property `description`
  - removed the request property `endTime`
  - removed the request property `startTime`
  - 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 optional request property `active`
  - added the new optional request property `expiry`
  - request body became optional
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - removed the non-success response with the status `422`
  - added the optional property `data` to the response with the `500` status
  - added the success response with the status `200`
- **2025-08-11** `db719f9e3d34`: 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/bluewave-labs/apis/checkmate-api/docs/maintenance-window/post.md) - [API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [Page](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/maintenance-window/post)