Delete Maintenance Window

DELETE /api/maintenance-windows/{id}

Path ParametersCopy Anchor Link

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

Example (cURL)Copy Anchor Link

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

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

ResponseCopy Anchor Link

Returns 204 No Content on success with an empty body.

Common errorsCopy Anchor Link

• 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)
• 403 with data.code: customerScopedTokenForbidden when the window is org-wide (no customer) and you are a customer-bound actor: a readonly user, an editor with customer assignments, or a customer-scoped token. Only an organization-wide admin or editor deletes org-wide windows; see Roles and the customer scope
• 404 Not Found when no maintenance window with the given ID exists