Maintenance Window aktualisieren

Aktualisiert ein Wartungsfenster partiell. Alle Felder sind optional; nur angegebene Felder werden geändert. Wenn targets oder tagIds angegeben werden, ersetzen sie die bestehende Auswahl vollständig.

PATCH /api/maintenance-windows/{id}

Pfad-Parameter

id (erforderlich): Die numerische ID des zu aktualisierenden Wartungsfensters.

Body

Alle Felder sind optional. Felder weglassen, um sie unverändert zu lassen.

{
  "name": "Erweitertes Deployment-Fenster",
  "endTime": "2026-07-11T03:00:00.000Z",
  "targets": [
    { "type": "website", "id": 101 },
    { "type": "dns", "id": 9 }
  ],
  "tagIds": [7, 12],
  "isActive": true
}

Aktualisierbare Felder

Feld	Typ	Hinweise
`name`	string	Anzeigename
`description`	string	Freitext-Notizen
`startTime`	ISO 8601 Datetime	Neuer Startzeitpunkt
`endTime`	ISO 8601 Datetime	Neuer Endzeitpunkt; muss nach `startTime` liegen
`isActive`	boolean	Aktivieren oder deaktivieren ohne Löschen
`isRecurring`	boolean	Wiederholung umschalten
`recurrencePattern`	object	Ersetzt das Wiederholungsmuster; Struktur identisch mit create
`targets`	`{ type, id }[]`	Ersetzt die vollständige Menge der expliziten Monitor-Ziele
`tagIds`	number[]	Ersetzt die vollständige Menge der Tag-IDs
`websiteId` / `icmpMonitorId` / …	number \| null	Legacy-Felder für einzelne Ziele
`customerId`	number	Kunden-Anker (nur für tag-only Fenster)

Ersetz-Semantik für targets und tagIds

Wenn targets oder tagIds im Request-Body enthalten ist, wird die gesamte bestehende Auswahl für dieses Feld ersetzt. Um alle expliziten Ziele zu entfernen, sende "targets": []; um alle Tags zu entfernen, sende "tagIds": [].

Kombinationsregeln

PATCH validiert den Ziel- und Tag-Scope über denselben Resolver wie create, führt jedoch nicht den create-zeitigen Zod-superRefine erneut aus. In der Praxis:

customerId kann nicht mit targets, tagIds oder Legacy-Feldern kombiniert werden.
Alle Monitore in targets müssen zum selben Kunden gehören; Mischung gibt { data: { code: "mixedCustomers" } } zurück.
Ein organisationsweites Nur-Tag-Fenster (Tags ohne customerId, targets oder Legacy-Felder) kann von Admin- oder Editor-Benutzern innerhalb der Organisation bearbeitet werden.

Readonly-Benutzer im Scope

Readonly-Benutzer, die dem Kunden des Fensters zugewiesen sind, können Wartungsfenster für diesen Kunden bearbeiten. Globale Support-Konten können dies nicht. Readonly-Benutzer können keine organisationsweiten Nur-Tag-Fenster erstellen oder aktualisieren.

Beispiel (cURL)

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

curl -X PATCH "$BASE_URL/api/maintenance-windows/42" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false}'

Antwort (Response)

Gibt das aktualisierte Wartungsfenster-Objekt in der gleichen Form zurück wie Maintenance Window abrufen.

Häufige Fehler

Status	Beschreibung
`400` (Validierung)	Die Aktualisierung würde das Fenster ohne Ziele zurücklassen, oder `customerId` wird mit anderen Zielfeldern kombiniert. Dies sind Zod-Validierungsfehler; der Response-Body ist ein Standard-Validierungsfehler, kein `{ data: { code } }`.
`400` `{ data: { code: "mixedCustomers" } }`	`targets` enthält Monitore verschiedener Kunden.
`400` `{ data: { code: "mixedTagOrganizations" } }`	`tagIds` enthält Tags aus verschiedenen Organisationen.
`401 Unauthorized`	Nicht angemeldet.
`403 Forbidden`	Kein Zugriff auf das Fenster (globale Support-Konten können nicht bearbeiten), oder readonly-Benutzer versucht einen organisationsweiten Nur-Tag-Scope zu setzen.
`404 Not Found`	Kein Wartungsfenster mit der angegebenen ID gefunden.
`404` `{ data: { code: "tagNotFound" } }`	Eine `tagId` existiert nicht in der Organisation.

Maintenance Window aktualisieren

Auf dieser Seite