v2

latestOpenAPI 3.0.02026-07-261859071.2 MB

Maintenance windows

Update a maintenance window

Partially updates a maintenance window. Only fields included in the request body are modified; omitted fields are left unchanged. Status-page-only fields live under statusPageVisibility and only take effect when statusPageVisibility.enabled: true.

put/v1/maintenance-windows/{id}

Path parameters

idinteger required

Headers

x-checkly-accountstring

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Request body

namestring

The maintenance window name.

tagsstring[]

The names of the checks and groups maintenance window should apply to.

startsAtstring date

The start date of the maintenance window.

endsAtstring date

The end date of the maintenance window.

repeatIntervalnumber nullable

The repeat interval of the maintenance window from the first occurance.

repeatEndsAtstring date nullable

The end date where the maintenance window should stop repeating.

pauseAllChecksboolean

Whether to pause all checks in the account (overrides tag scope).

silenceAlertsTagsstring[]

Tags defining which checks have alerts silenced (when silenceAllAlerts is false).

silenceAllAlertsboolean

Whether to silence alerts for all checks (overrides silenceAlertsTags scope).

descriptionstring nullable

A description of the maintenance window. When the window is visible on status pages, this description is shown there too.

repeatUnit'DAY' | 'WEEK' | 'MONTH' nullable

Example request

{
  "name": "Maintenance Window",
  "tags": [
    "production"
  ],
  "startsAt": "2022-08-24",
  "endsAt": "2022-08-25"
}

Response

Successful

idnumber required

The id of the maintenance window.

namestring required

tagsstring[]

The names of the checks and groups maintenance window should apply to.

startsAtstring date required

endsAtstring date required

repeatIntervalnumber nullable

repeatUnit'DAY' | 'WEEK' | 'MONTH' nullable

repeatEndsAtstring date nullable

descriptionstring nullable

pauseAllChecksboolean

silenceAlertsTagsstring[]

silenceAllAlertsboolean

created_atstring date required

The creation date of the maintenance window.

updated_atstring date nullable required

The last date that the maintenance window was updated.

Example response

{
  "id": 1,
  "tags": [
    "production"
  ]
}