Abonnenten einer Statusseite löschen
Löscht einen Abonnenten und seine gespeicherten Einwilligungsnachweise unwiderruflich. Org-weit Admin oder Editor, kundengebunden nach der Eigentumsklasse der Seite.
DELETE /api/status-pages/:id/subscribers/:subscriberId
Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin oder editor (organisationsweites readonly bleibt lesend). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen stattdessen der Eigentumsklasse der Seite: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization.
Das ist ein echtes Löschen (Hard Delete), nicht das öffentliche Ein-Klick-Abmelden. Der öffentliche Abmelde-Link behält die Abonnenten-Zeile mit status: "unsubscribed" als Nachweis, dass keine weiteren E-Mails mehr verschickt werden dürfen. Dieser Endpunkt beantwortet dagegen Löschanfragen (DSGVO Art. 17) und entfernt die Zeile vollständig, inklusive E-Mail-Adresse, Zeitpunkt der Einwilligung, IP-Adresse und User-Agent.
Pfad-Parameter
| Parameter | Beschreibung |
|---|---|
id | Statusseiten-ID oder publicId (UUID) |
subscriberId | Abonnenten-ID (positive Ganzzahl) |
Beispiel (cURL)
curl -X DELETE "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers/42" \
-H "Authorization: Bearer $TOKEN"Antwort
{ "ok": true }Häufige Fehler
401 Unauthorized, wenn du nicht authentifiziert bist400 User must belong to an organization(data.code: userMustBelongToOrg), wenn sich aus Session oder Token keine Organisation ableiten lässt403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst, oder dein Kunden-Scope diese Statusseite nicht einschließt403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden400 Invalid Status page identifier, wennidkeine gültige numerische ID oder UUID ist (keindata.code)404 Status page not found, wennidwohlgeformt ist, aber keine Statusseite dazu existiert (keindata.code)404 Status page not found(data.code: statusPageNotFound), wennidsich zu einer echten Statusseite auflöst, diese aber zu einer anderen Organisation gehört oder außerhalb deines Kunden-Scopes liegt400 Invalid subscriber id(data.code: invalidSubscriberId), wennsubscriberIdsich nicht als positive Ganzzahl parsen lässt404 Subscriber not found(data.code: subscriberNotFound), wennsubscriberIdnicht existiert oder zu einer anderen Statusseite alsidgehört
id wird aufgelöst und geprüft, bevor subscriberId überhaupt geparst wird, ein fehlerhaftes id ist also immer der Fehler, den du zuerst siehst.
Statusseite löschen
Löscht eine Statusseite endgültig. Erfordert die Rolle `admin` oder `editor`.
Abonnenten aller Statusseiten exportieren
Lädt die Abonnenten der ausgewählten Statusseiten als CSV herunter, mit denselben Filtern wie die Liste. Org-weit Admin oder Editor, kundengebunden die Seiten, die du pflegen darfst.