Wartungsfenster abrufen

Gibt ein einzelnes Wartungsfenster anhand der ID zurück (inkl. Target-Relation).

GET /api/maintenance-windows/:id

Authentifizierung

Erfordert eine gültige Session.

Header: Authorization: Bearer <token>

Hinweis (API-Token Scope): Wenn du ein Customer-scoped API-Token nutzt, muss das Wartungsfenster zu diesem Kunden gehören.

Parameter

id (Path, required): Wartungsfenster-ID.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/maintenance-windows/5" \
  -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,
  "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: Je nach Ziel kann die Response stattdessen auch eine dieser Relationen enthalten: icmpMonitor, smtpMonitor, sshMonitor, ftpMonitor, imapPopMonitor. Verschachtelte customer-Objekte werden nicht zurückgegeben.

Häufige Fehler

400 Invalid maintenance window ID wenn :id ungültig ist
404 Maintenance window not found wenn das Fenster nicht existiert
401 Unauthorized wenn du nicht angemeldet bist
403 Forbidden wenn du keinen Zugriff auf das Ziel/den Kunden hast
500 Maintenance window target is missing wenn kein gültiges Ziel am Wartungsfenster hinterlegt ist