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 ist404 Not Found(statusPageTemplateNotFound), wenn es die Vorlage nicht gibt oder sie einer anderen Organisation gehört401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden(statusPagesModuleDisabled), wenn das Statusseiten-Modul nicht aktiviert ist403 Forbidden(forbidden), wenn deine Rolle nicht schreiben darf403 Forbidden(customerScopedTokenForbidden) für einen kundengebundenen Login oder Token