Uptimeify Docs

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

FeldTypPflichtStandardBeschreibung
bodystringJa-Der Text des Updates (1-5000 Zeichen), steht auf der öffentlichen Seite.
notifySubscribersbooleanNeintrueAn 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.issues nennt das Feld
  • 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 abgesagt wurde

Auf dieser Seite