Maintenance Window erstellen

POST /api/maintenance-windows

Body

{
  "name": "Datenbank-Migration",
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "targets": [
    { "type": "website", "id": 101 },
    { "type": "icmp", "id": 5 }
  ],
  "tagIds": [7],
  "description": "Geplante Schema-Migration",
  "isRecurring": false,
  "isActive": true
}

Pflichtfelder

• name (string): Eine freundliche Bezeichnung für das Fenster.
• startTime (ISO 8601 Datetime): Zeitpunkt, an dem das Fenster beginnt.
• endTime (ISO 8601 Datetime): Zeitpunkt, an dem das Fenster endet. Muss nach startTime liegen.
• Mindestens ein Zielfeld (siehe unten).

Zielauswahl (gegenseitig ausschließende Modi)

Genau ein Targeting-Modus muss verwendet werden. targets und tagIds können innerhalb des Multi-Monitor-Modus kombiniert werden.

Nur-Tag-Modus (organisationsweit)

Wird tagIds ohne customerId, targets oder Legacy-Felder gesendet, entsteht ein organisationsweites Wartungsfenster. Es deckt dynamisch jeden Monitor der gesamten Organisation ab, der aktuell die angegebenen Tags trägt — über alle Kunden hinweg.

{
  "name": "Infra-Tag-Freeze",
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "tagIds": [7]
}

• Erfordert Admin- oder Editor-Rolle. Readonly-Benutzer, die dies versuchen, erhalten 403 Forbidden.
• Die Tag-Zugehörigkeit wird live zur Prüfzeit aufgelöst — nach der Fenstererstellung getaggte Monitore werden automatisch abgedeckt.
• Alle tagIds müssen zur selben Organisation gehören; das Mischen von Tags verschiedener Organisationen gibt 400 mixedTagOrganizations zurück.

Kombinationsregeln

• Mindestens ein Zielfeld ist erforderlich. Das Weglassen aller Felder ist ein Zod-Validierungsfehler (Standard-400 mit Validierungsantwort, kein data.code-Fehler).
• customerId (Kunden-Ebene-Modus) kann nicht mit targets, tagIds oder Legacy-Feldern kombiniert werden. Das Kombinieren ist ein Zod-Validierungsfehler (Standard-400).
• Alle Monitore in targets müssen zum selben Kunden gehören; das Mischen von Kunden gibt { data: { code: "mixedCustomers" } } zurück.
• Alle tagIds müssen zur selben Organisation gehören; das Mischen gibt { data: { code: "mixedTagOrganizations" } } zurück.

Optionale Felder

Wiederholung

{
  "frequency": "weekly",
  "interval": 1,
  "daysOfWeek": [1, 3],
  "dayOfMonth": null,
  "endRecurrenceDate": "2026-12-31"
}

Dynamisches Tag-Verhalten

Die Tag-Abdeckung wird vom Monitoring-Worker live zum Zeitpunkt der Prüfung aufgelöst. Ein Monitor, der nach der Fenstererstellung getaggt wird, wird automatisch abgedeckt — ohne das Fenster zu aktualisieren. Das Entfernen eines Tags von einem Monitor beendet die Abdeckung sofort.

Beispiel (cURL)

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

curl -X POST "$BASE_URL/api/maintenance-windows" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Datenbank-Migration",
    "startTime": "2026-07-10T22:00:00.000Z",
    "endTime": "2026-07-11T01:00:00.000Z",
    "targets": [
      { "type": "website", "id": 101 }
    ]
  }'

Antwort (Response)

{
  "id": 42,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "customerId": 1,
  "name": "Datenbank-Migration",
  "description": null,
  "startTime": "2026-07-10T22:00:00.000Z",
  "endTime": "2026-07-11T01:00:00.000Z",
  "isRecurring": false,
  "recurrencePattern": null,
  "isActive": true,
  "targets": [
    { "type": "website", "id": 101 }
  ],
  "tags": [],
  "websiteId": null,
  "icmpMonitorId": null,
  "smtpMonitorId": null,
  "sshMonitorId": null,
  "ftpMonitorId": null,
  "imapPopMonitorId": null,
  "dnsMonitorId": null,
  "customerIpId": null,
  "customerDomainId": null,
  "createdAt": "2026-06-29T10:00:00.000Z",
  "updatedAt": "2026-06-29T10:00:00.000Z"
}

Häufige Fehler