Sign in
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

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.

repeatIntervalinteger nullable

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

repeatEndsAtstring date nullable

An inclusive calendar date in the configured timezone (UTC when unset) on which occurrences may start. Prefer YYYY-MM-DD. For backward compatibility, other accepted date-time values are normalized to the UTC calendar date of the parsed instant. The final occurrence runs for its full configured duration.

timezonestring nullable

Named IANA time zone used for recurring maintenance scheduling. UTC offset identifiers such as "+05:00" are not accepted. On create, omission or null uses UTC. On update, omission preserves the existing value; null or UTC resets scheduling to UTC. Changing only this field keeps startsAt and endsAt as the same absolute instants; include recalculated anchors to preserve the existing local date and time.

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",
  "timezone": "America/New_York"
}

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
timezonestring 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"
  ],
  "projectBindings": {
    "owner": {
      "binding": {
        "logicalId": "homepage-check"
      }
    },
    "references": [
      {
        "binding": {
          "logicalId": "homepage-check"
        }
      }
    ]
  }
}

Changes

Changed in 2 of the 4 revisions of this API.115

  • 87d29dc7b4fe1See the full diff
    • ○

      added the optional property projectBindings to the response with the 200 status

      response-optional-property-added

    This revision also has 566 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 9e903da4f3da114See the full diff
    • ▲

      the repeatInterval request property type/format changed from number/ to integer/

      request-property-type-changed

    • ●

      the repeatInterval request property's max was set to 365.00

      request-property-max-set

    • ○

      added the new optional request property statusPageVisibility/showAffectedServices

      new-optional-request-property

    • ○

      added the new optional request property timezone

      new-optional-request-property

    • ○

      added the optional property statusPageVisibility/showAffectedServices to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property timezone to the response with the 200 status

      response-optional-property-added