v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
maintenance-window

Update a maintenance window.

Spaces method and path for this operation:

<div><span class="operation-verb patch">patch</span>&nbsp;<span class="operation-path">/s/{space_id}/api/maintenance_window/{id}</span></div>

Refer to Spaces for more information.

[Required authorization] Route required privileges: write-maintenance-window.

patch/api/maintenance_window/{id}

Path parameters

idstring required

The identifier for the maintenance window.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

enabledboolean

Whether the current maintenance window is enabled. Disabled maintenance windows do not suppress notifications.

titlestring

The name of the maintenance window. While this name does not have to be unique, a distinctive name can help you identify a specific maintenance window.

Response

Indicates a successful call.

created_atstring required

The date and time when the maintenance window was created.

created_bystring nullable

The identifier for the user that created the maintenance window.

enabledboolean required

Whether the current maintenance window is enabled. Disabled maintenance windows do not suppress notifications.

idstring required

The identifier for the maintenance window.

status'running' | 'upcoming' | 'finished' | 'archived' | 'disabled' required

The current status of the maintenance window.

titlestring required

The name of the maintenance window.

updated_atstring required

The date and time when the maintenance window was last updated.

updated_bystring nullable

The identifier for the user that last updated this maintenance window.