---
title: "POST /api/maintenance_windows"
method: POST
path: "/api/maintenance_windows"
tags: ["maintenance_windows"]
---

# POST /api/maintenance_windows

`POST /api/maintenance_windows`

## Request

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

## Headers

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

## Request body

- MaintenanceWindowRequest
  - `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

## Response `201`

- 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)