---
title: "PATCH /api/maintenance_windows/{key}"
method: PATCH
path: "/api/maintenance_windows/{key}"
tags: ["maintenance_windows"]
---

# PATCH /api/maintenance_windows/{key}

`PATCH /api/maintenance_windows/{key}`

## Request

- Base URL: `https://cronitor.io`
- URL: `https://cronitor.io/api/maintenance_windows/{key}`
- Auth: HTTP basic

## Path parameters

- `key` string, required

## Headers

- `Cronitor-Version` '2025-11-28' | '2020-10-01'

## Request body

- PatchedMaintenanceWindowRequest
  - `name` string
  - `description` string, nullable
  - `start` string, date-time
  - `end` string, date-time
  - `affects_all_monitors` boolean
  - `affects_statuspage_components` boolean
  - `environment` string, nullable: Environment key.
  - `statuspages` string[]: Status page keys.
  - `monitors` unknown[]
    - unknown
  - `groups` unknown[]
    - unknown

## Response `200`

- MaintenanceWindow
  - `key` string, required
  - `name` string, required
  - `description` string, nullable
  - `start` string, date-time, required
  - `end` string, date-time, required
  - `affects_all_monitors` boolean
  - `affects_statuspage_components` boolean
  - `environment` string, nullable: Environment key.
  - `statuspages` string[]: Status page keys.
  - `monitors` unknown[]
    - unknown
  - `groups` unknown[]
    - unknown
  - `all_affected_monitors` string, required
  - `duration` integer, required: Returns the total duration of the maintenance window in seconds.
  - `state` string, required: Returns whether the window is currently past|ongoing|upcoming.
  - `created` string, date-time, required
  - `updated` string, date-time, required

---

[API](https://skmtc.dev/cronitor/apis/cronitor-api.md) - [All operations](https://skmtc.dev/cronitor/apis/cronitor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cronitor/apis/cronitor-api/revisions/62fb38ef4462?raw)