Wenn eine Person in deiner Anwendung ihr Konto schließt oder die Löschung ihrer Daten verlangt, musst du auch ihre Daten bei FlowModels entfernen. Das geht in der Oberfläche oder automatisiert über die Schnittstelle. Zu jeder Löschung bekommst du einen Löschbeleg, mit dem du später nachweisen kannst, was entfernt wurde.
Endnutzer auflisten und abrufen
| Aufgabe | Aufruf |
|---|---|
| alle Endnutzer | GET /v1/end-users |
| anlegen oder vorhandenen holen | POST /v1/end-users |
| einen Endnutzer abrufen | GET /v1/end-users/{id} |
| Metadaten oder Erinnerungen ändern | PATCH /v1/end-users/{id} |
| löschen | DELETE /v1/end-users/{id} |
Die Liste liefert je Seite bis zu 100 Einträge. Steht has_more auf true, holst du die nächste Seite mit after und der UUID aus last_id.
Jeder Eintrag enthält die id, deine external_identifier und die metadata. Für alle Aufrufe mit {id} brauchst du die id, nicht deine eigene Kennung. Wenn du nur deine Kennung kennst, liefert dir POST /end-users mit dieser Kennung den vorhandenen Endnutzer samt id, ohne einen zweiten anzulegen.
Metadaten pflegen
Mit metadata hinterlegst du eigene Angaben zum Endnutzer, etwa den Tarif aus deinem System:
curl -X PATCH https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"metadata": {"tarif": "business"}}'
Neue Werte werden mit den vorhandenen zusammengeführt. Erlaubt sind höchstens 50 Einträge, Schlüssel bis 64 Zeichen und Werte als Text bis 1.000 Zeichen oder null. Im selben Aufruf kannst du mit memory_extraction_enabled die automatischen Erinnerungen ein- oder ausschalten. Die external_identifier lässt sich nicht ändern.
Einen Endnutzer löschen
curl -X DELETE https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab \
-H "Authorization: Bearer at_dein_schluessel"
Damit entfernst du die Unterhaltungen, Dateien und Erinnerungen dieser Person. Das lässt sich nicht rückgängig machen. Abrechnungs- und Verbrauchszeilen bleiben aus Aufbewahrungsgründen erhalten, damit deine Rechnungen stimmen.
Die Antwort "deleted": true bestätigt, dass die Löschung angestoßen ist und die Daten nicht mehr verwendet werden. Gespeicherte Dateien entfernen wir anschließend im Hintergrund. Ob das abgeschlossen ist, zeigt dir der Löschbeleg.
Den Löschbeleg abrufen
curl https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/erasures \
-H "Authorization: Bearer at_dein_schluessel"
Achte auch hier auf den Unterstrich in end_users. Die Belege bleiben nach der Löschung abrufbar, denn genau dann brauchst du den Nachweis. Einen einzelnen Beleg holst du mit GET /end_users/{id}/erasures/{beleg}.
{
"id": "018f9a2b-…",
"object": "end_user.erasure",
"status": "completed",
"requested_at": "2026-11-05T08:15:00+00:00",
"completed_at": "2026-11-05T08:15:04+00:00",
"manifest_summary": {
"resources": {
"memories": {"before": 12, "after": 0},
"end_user_files": {"before": 3, "after": 0}
},
"objects_remaining": 0
}
}
status:pending(angelegt),objects_pending(Dateien werden noch entfernt),completed(abgeschlossen),objects_partial(teilweise abgeschlossen) oderfailed(fehlgeschlagen)completed_at: Zeitpunkt des Abschlusses,nullsolange noch Dateien entfernt werdenmanifest_summary.resources: je Datenart die Anzahl vor und nach der Löschungobjects_remaining: wie viele gespeicherte Objekte noch offen sind
Der Beleg enthält nur Zahlen, keine Texte, keine Dateinamen und keine Kennungen. Du kannst ihn also unbedenklich in deinem eigenen Löschprotokoll ablegen.
In der Oberfläche
Unter Endnutzer › Details anzeigen löschst du einen Endnutzer, indem du seine Kennung zur Bestätigung eintippst und auf Endnutzer löschen klickst. Der Bereich Löschläufe unter der Endnutzerliste und in den Details zeigt jeden Lauf mit Gestartet, Status, Grund, Offene Objekte und Abschluss. Details stehen in Endnutzer deiner Anwendung verwalten.
Ein abgeschlossener Lauf entfernt den Endnutzer aus der Liste, der Nachweis bleibt im Bereich Löschläufe sichtbar, auch für Löschungen über die Schnittstelle.
Wenn etwas nicht klappt
404 end_user_not_found: Dieidgibt es nicht oder sie gehört zu einem anderen Team. Prüfe, ob du versehentlich deineexternal_identifierstatt deridverwendest.- Status
objects_partialoderfailed: Ein Teil der Dateien konnte noch nicht entfernt werden. Vorübergehende Speicherfehler versuchen wir erneut. Bleibt der Status so, wende dich mit deriddes Endnutzers an den Support.