Maintenance Window löschen

DELETE /api/maintenance-windows/{id}

Pfad-ParameterAnkerlink kopieren

• id (erforderlich): Die numerische ID des zu löschenden Wartungsfensters.

Beispiel (cURL)Ankerlink kopieren

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

curl -X DELETE "$BASE_URL/api/maintenance-windows/42" \
  -H "Authorization: Bearer $TOKEN"

Antwort (Response)Ankerlink kopieren

Gibt bei Erfolg 204 No Content mit leerem Body zurück.

Häufige FehlerAnkerlink kopieren

• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden wenn du keinen Zugriff auf die Organisation hast oder das Fenster nicht im Scope liegt (globale Support-Konten können keine Wartungsfenster löschen)
• 403 mit data.code: customerScopedTokenForbidden wenn das Fenster organisationsweit ist (ohne Kunden) und du ein kundengebundener Akteur bist: ein readonly-Benutzer, ein editor mit Kundenzuweisungen oder ein Customer-Scoped Token. Organisationsweite Fenster löscht nur ein organisationsweiter Admin oder Editor; siehe Rollen und der Kunden-Scope
• 404 Not Found wenn kein Wartungsfenster mit der angegebenen ID existiert