Wartungsfenster aktualisieren

Aktualisiert ein bestehendes Wartungsfenster. Alle Felder sind optional (Partial Update).

PATCH /api/maintenance-windows/:id

Authentifizierung

Erfordert eine gültige Session.

Header: Authorization: Bearer <token>

Hinweis: Global-Supporter dürfen keine Wartungsfenster aktualisieren (403). Read-only Nutzer dürfen es.

Parameter

id (Path, required): Wartungsfenster-ID.

Anfrage (Request Body)

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

Hinweise:

Du kannst die Target-IDs (websiteId, icmpMonitorId, ...) nicht ändern. Es werden nur die Felder des Wartungsfensters aktualisiert.
description kann auf null gesetzt werden, um sie zu löschen.
Wenn du startTime und/oder endTime änderst, muss endTime nach startTime liegen.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-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-25T03:00:00.000Z","endTime":"2026-02-25T05:00:00.000Z","isRecurring":true,"recurrencePattern":{"frequency":"weekly","interval":1,"daysOfWeek":[1]},"isActive":true}'

Antwort (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-25T03:00:00.000Z",
  "endTime": "2026-02-25T05: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"
}

Häufige Fehler

400 Invalid maintenance window ID wenn :id ungültig ist
400 End time must be after start time wenn du startTime/endTime auf einen ungültigen Zeitraum setzt
401 Unauthorized wenn du nicht angemeldet bist
403 Forbidden wenn du keinen Zugriff auf das Wartungsfenster hast
404 Maintenance window not found wenn das Wartungsfenster nicht existiert