Wartungsfenster auflisten

GET /api/maintenance-windows

Gibt Wartungsfenster zurück, standardmäßig auf deine Organisation scoped.

Du kannst nach einem konkreten Ziel (z. B. websiteId) oder nach customerId/organizationId filtern.

Authentifizierung

Erfordert eine gültige Session.

Header: Authorization: Bearer <token>

Query Parameter

websiteId (optional)
customerId (optional)
organizationId (optional, Standard: deine Session-Organisation)
activeOnly (optional): true liefert nur aktive Fenster
Target-Filter (optional): icmpMonitorId, smtpMonitorId, sshMonitorId, ftpMonitorId, imapPopMonitorId

Hinweis (API-Token Scope): Wenn du ein Customer-scoped API-Token nutzt, sind Ergebnisse auf diesen Kunden beschränkt. Ein anderer customerId liefert 403.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/maintenance-windows?websiteId=101" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)

[
  {
    "id": 5,
    "websiteId": 101,
 "icmpMonitorId": null,
 "smtpMonitorId": null,
 "sshMonitorId": null,
 "ftpMonitorId": null,
 "imapPopMonitorId": null,
    "customerId": 12,
   "customerName": "Acme Corp",
    "name": "Wöchentliche Wartung",
    "description": "Geplante Downtime",
    "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-20T10:00:00.000Z",
    "website": {
      "id": 101,
      "url": "https://example.com"
    }
  }
]

Hinweis: Der List-Endpoint enthält nur die website-Relation (wenn websiteId gesetzt ist). Verschachtelte customer-Objekte und Monitor-Relationen sind in der Liste nicht enthalten. Für Anzeige und Filter steht stattdessen ein schlankes Top-Level-Feld customerName zur Verfügung.

Häufige Fehler

401 Unauthorized wenn du nicht angemeldet bist
403 Forbidden wenn du keinen Zugriff auf das Ziel hast