Skip to Content
Uptimeify Docs

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

ParameterBeschreibung
idStatusseiten-ID oder publicId (UUID)
subscriberIdAbonnenten-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 bist
  • 400 User must belong to an organization (data.code: userMustBelongToOrg), wenn sich aus Session oder Token keine Organisation ableiten lässt
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst, oder dein Kunden-Scope diese Statusseite nicht einschließt
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 400 Invalid Status page identifier, wenn id keine gültige numerische ID oder UUID ist (kein data.code)
  • 404 Status page not found, wenn id wohlgeformt ist, aber keine Statusseite dazu existiert (kein data.code)
  • 404 Status page not found (data.code: statusPageNotFound), wenn id sich zu einer echten Statusseite auflöst, diese aber zu einer anderen Organisation gehört oder außerhalb deines Kunden-Scopes liegt
  • 400 Invalid subscriber id (data.code: invalidSubscriberId), wenn subscriberId sich nicht als positive Ganzzahl parsen lässt
  • 404 Subscriber not found (data.code: subscriberNotFound), wenn subscriberId nicht existiert oder zu einer anderen Statusseite als id gehö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.

Auf dieser Seite