Wartung absagen

POST /api/status-pages/maintenances/{id}/cancel

Sagt eine bevorstehende Wartung (state: scheduled) ab. Sie verschwindet von der öffentlichen Seite; Abonnenten, die die Ankündigung bekommen haben (notifyOnSchedule), erhalten maintenance_cancelled, Erinnerung und Beginn gehen nicht mehr raus. Eine laufende Wartung beendest du mit Wartung beenden.

ZugriffAnkerlink kopieren

Organisations-admin und editor. Ein kundengebundener Nutzer oder API-Token erreicht nur Wartungen, deren Status-Seiten alle zu einem Kunden in seinem Bereich gehören; eine Seite ohne Kunde (customerId: null) ist Org-weiten Rollen vorbehalten. Eine Wartung einer anderen Organisation antwortet 404 (statusPageMaintenanceNotFound). IDs im Pfad nehmen die numerische ID oder die publicId. Die Änderung steht im Audit-Protokoll der Organisation.

Beispiel (cURL)Ankerlink kopieren

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

curl -X POST "$BASE_URL/api/status-pages/maintenances/12/cancel" \
  -H "Authorization: Bearer $TOKEN"

AntwortAnkerlink kopieren

200 OK mit der Wartung, jetzt state: cancelled und mit cancelledAt.

Häufige FehlerAnkerlink kopieren

• 400 Bad Request (invalidIdentifier), wenn eine ID weder Zahl noch UUID ist
• 401 Unauthorized, wenn du nicht angemeldet bist
• 403 Forbidden (forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
• 403 Forbidden (statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist
• 404 Not Found (statusPageMaintenanceNotFound), wenn die Wartung nicht existiert oder zu einer anderen Organisation gehört
• 409 Conflict (statusPageMaintenanceClosed), wenn die Wartung nicht bevorsteht (läuft, abgeschlossen oder schon abgesagt)