Uptimeify Docs

Statusseiten-Vorlage löschen

Löscht eine Vorlage. Daraus entstandene Vorfälle bleiben, wie sie sind.

DELETE /api/status-pages/templates/{id}

Eine Vorlage füllt das Formular für einen neuen öffentlichen Vorfall (kind: incident) oder für ein Update zu einem laufenden (kind: update) vor. Sie veröffentlicht selbst nichts; Vorfälle entstehen weiter mit Vorfall anlegen.

Zugriff

Organisations-admin und editor mit uneingeschränktem Umfang: ein kundengebundener Login oder API-Token bekommt 403 (customerScopedTokenForbidden), weil eine Vorlage der ganzen Organisation gehört. Eine Vorlage einer anderen Organisation antwortet 404 (statusPageTemplateNotFound). Pfad-IDs nehmen die numerische ID oder die publicId. Die Änderung steht im Audit-Log der Organisation.

Beispiel (cURL)

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

curl -X DELETE "$BASE_URL/api/status-pages/templates/4" \
  -H "Authorization: Bearer $TOKEN"

Antwort

204 No Content, kein Body. Ein zweites DELETE antwortet 404.

Häufige Fehler

  • 400 Bad Request (invalidIdentifier), wenn die ID weder Zahl noch UUID ist
  • 404 Not Found (statusPageTemplateNotFound), wenn es die Vorlage nicht gibt oder sie einer anderen Organisation gehört
  • 401 Unauthorized, wenn du nicht angemeldet bist
  • 403 Forbidden (statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist
  • 403 Forbidden (forbidden), wenn deine Rolle nicht schreiben darf
  • 403 Forbidden (customerScopedTokenForbidden) für einen kundengebundenen Login oder Token

Auf dieser Seite