---
type: api
title: Maintenance windows
description: You can schedule single or recurring maintenance windows to temporarily reduce rule notifications. For example, a maintenance window prevents false alarms during planned outages.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/group/endpoint-maintenance-window
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/group/endpoint-maintenance-window
products:
  - Kibana
---

# Maintenance windows

`maintenance-window`

You can schedule single or recurring maintenance windows to temporarily reduce rule notifications. For example, a maintenance window prevents false alarms during planned outages.

[Maintenance window documentation](https://www.elastic.co/docs/explore-analyze/alerts-cases/alerts/maintenance-windows)

- [Create a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-post-maintenance-window): `POST` `/api/maintenance_window`, `POST` `/s/{space_id}/api/maintenance_window`
- [Search for a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-get-maintenance-window-find): `GET` `/api/maintenance_window/_find`, `GET` `/s/{space_id}/api/maintenance_window/_find`
- [Delete a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-delete-maintenance-window-id): `DELETE` `/api/maintenance_window/{id}`, `DELETE` `/s/{space_id}/api/maintenance_window/{id}`
- [Get maintenance window details.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-get-maintenance-window-id): `GET` `/api/maintenance_window/{id}`, `GET` `/s/{space_id}/api/maintenance_window/{id}`
- [Update a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-patch-maintenance-window-id): `PATCH` `/api/maintenance_window/{id}`, `PATCH` `/s/{space_id}/api/maintenance_window/{id}`
- [Archive a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-post-maintenance-window-id-archive): `POST` `/api/maintenance_window/{id}/_archive`, `POST` `/s/{space_id}/api/maintenance_window/{id}/_archive`
- [Unarchive a maintenance window.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v9/operation/operation-post-maintenance-window-id-unarchive): `POST` `/api/maintenance_window/{id}/_unarchive`, `POST` `/s/{space_id}/api/maintenance_window/{id}/_unarchive`