---
title: "Delete Maintenance Window"
description: "Permanently deletes a maintenance window. Active alert suppression ends immediately."
---

`DELETE /api/maintenance-windows/{id}`

## Path Parameters

- `id` (required): The numeric ID of the maintenance window to delete.

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X DELETE "$BASE_URL/api/maintenance-windows/42" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

Returns `204 No Content` on success with an empty body.

## Common errors

- `401 Unauthorized` when you are not logged in
- `403 Forbidden` when you cannot access the organization or the window is out of scope (global supporter accounts cannot delete maintenance windows)
- `404 Not Found` when no maintenance window with the given ID exists