---
title: "Wartung absagen"
description: "Sagt eine bevorstehende Wartung ab und informiert die Abonnenten."
---

`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](/de/api/status-pages/complete-status-page-maintenance).

## Zugriff

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)

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

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

## Antwort

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

## Häufige Fehler

- `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)