Wartungs-Update veröffentlichen
Veröffentlicht ein Update zu einer Wartung auf der Seite und an die Abonnenten.
POST /api/status-pages/maintenances/{id}/updates
Hängt ein öffentliches Update an eine Wartung, vorher, währenddessen oder danach.
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.
Request-Body
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
body | string | Ja | - | Der Text des Updates (1-5000 Zeichen), steht auf der öffentlichen Seite. |
notifySubscribers | boolean | Nein | true | An Abonnenten als maintenance_update senden. Derselbe Text zweimal an derselben Wartung geht einmal raus. |
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X POST "$BASE_URL/api/status-pages/maintenances/12/updates" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"body": "The upgrade takes 20 minutes longer than planned."}'Antwort
201 Created:
{
"id": 31,
"publicId": "7c2d4e6f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
"body": "The upgrade takes 20 minutes longer than planned.",
"createdAt": "2026-11-03T22:40:00.000Z"
}Häufige Fehler
400 Bad Request(invalidRequestBody), wenn ein Feld fehlt, den falschen Typ hat oder unbekannt ist;data.issuesnennt das Feld400 Bad Request(invalidIdentifier), wenn eine ID weder Zahl noch UUID ist401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden(forbidden), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden403 Forbidden(statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist404 Not Found(statusPageMaintenanceNotFound), wenn die Wartung nicht existiert oder zu einer anderen Organisation gehört409 Conflict(statusPageMaintenanceClosed), wenn die Wartung abgesagt wurde
Abonnenten einer Status-Seite auflisten
Gibt die E-Mail- und RSS-Abonnenten einer Status-Seite zurück, dazu exakte Zählwerte je Status. Erfordert Admin- oder Editor-Rolle.
Eigene Domain entfernen
Entfernt eine eigene Domain von einer Status-Seite. Löscht den Domain-Datensatz; die customDomainId der Status-Seite wird automatisch auf null gesetzt. Nur Admin.