Update Maintenance Window

PATCH /api/maintenance-windows/:id

Authentication

Requires a valid session.

Header: Authorization: Bearer <token>

Note: Global supporter users are not allowed to update maintenance windows (403). Read-only users are allowed.

Parameters

id (Path, required): Maintenance window ID.

Request Body

All fields are optional.

{
  "name": "Server Upgrade (updated)",
  "description": null,
  "startTime": "2026-02-25T02:00:00.000Z",
  "endTime": "2026-02-25T04:00:00.000Z",
  "isRecurring": true,
  "recurrencePattern": {
    "frequency": "weekly",
    "interval": 1,
    "daysOfWeek": [1]
  },
  "isActive": true
}

Notes:

You cannot change the target IDs (websiteId, icmpMonitorId, ...). Only the window fields can be updated.
description can be set to null to clear it.
If you update startTime and/or endTime, endTime must be after startTime.

Example (cURL)

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

curl -X PATCH \
  "$BASE_URL/api/maintenance-windows/5" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Server Upgrade (updated)","description":null,"startTime":"2026-02-25T02:00:00.000Z","endTime":"2026-02-25T04:00:00.000Z","isRecurring":true,"recurrencePattern":{"frequency":"weekly","interval":1,"daysOfWeek":[1]},"isActive":true}'

Example Response

{
  "id": 5,
  "websiteId": 101,
  "icmpMonitorId": null,
  "smtpMonitorId": null,
  "sshMonitorId": null,
  "ftpMonitorId": null,
  "imapPopMonitorId": null,
  "customerId": 12,
  "name": "Server Upgrade (updated)",
  "description": null,
  "startTime": "2026-02-25T02:00:00.000Z",
  "endTime": "2026-02-25T04:00:00.000Z",
 "isRecurring": true,
 "recurrencePattern": {
  "frequency": "weekly",
  "interval": 1,
  "daysOfWeek": [1]
 },
  "isActive": true,
  "createdBy": "<user-id>",
  "createdAt": "2026-02-20T10:00:00.000Z",
  "updatedAt": "2026-02-21T11:00:00.000Z"
}

Common Errors

400 Invalid maintenance window ID if :id is invalid
400 End time must be after start time if you update the time range to an invalid value
401 Unauthorized if you are not authenticated
403 Forbidden if you do not have access
404 Maintenance window not found if the maintenance window does not exist