DELETE
/
v1
/
maintenance-windows
/
{id}
Delete a maintenance window
curl --request DELETE \
  --url https://api.checklyhq.com/v1/maintenance-windows/{id} \
  --header 'Authorization: <api-key>'
This response does not have an example.

​
Overview

The Delete Maintenance Window endpoint permanently removes a maintenance window from your account. This action cannot be undone and will restore normal alerting for all affected checks. Common Use Cases:
  • Window Cleanup
  • Completed Maintenance
  • Schedule Changes
  • Resource Management
Deleting maintenance windows immediately restores normal alerting for all affected checks. Ensure maintenance activities are complete before deletion.
Normal alerting resumes immediately after maintenance window deletion. Plan deletion timing appropriately to avoid unwanted alerts.

Authorizations

​
Authorization
string
header
required

The Checkly Public API uses API keys to authenticate requests. You can get the API Key here.

Your API key is like a password: keep it secure!

Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID.

For example, set Authorization header while using cURL:

curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"

Headers

​
x-checkly-account
string

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

Path Parameters

​
id
integer
required

Response

No Content