---
title: "Create a maintenance window"
method: POST
path: "/v1/maintenance-windows"
tags: ["Maintenance"]
---

# Create a maintenance window

`POST /v1/maintenance-windows`

Schedule a maintenance window to suppress alerts.

## Request body

- MaintenanceCreate
  - `name` string, required
  - `start_date` string, date-time, required
  - `end_date` string, date-time, required
  - `monitors` string[], required
  - `statuspages` string[]
  - `title` LocalizedText — Localized text object with language keys
    - `en` string
    - `fr` string
    - `de` string
    - `ru` string
    - `nl` string
    - `pl` string
    - `se` string
  - `updates` object[]
    - `text` LocalizedText — Localized text object with language keys
      - `en` string
      - `fr` string
      - `de` string
      - `ru` string
      - `nl` string
      - `pl` string
      - `se` string
    - `date` string, date-time
  - `notificationOption` 'none' | 'immediate' | 'scheduled'
  - `notificationMinutes` integer

## Response `201`

Maintenance window created

- object
  - `uuid` string

---

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