FlowModels

Endnutzer per API verwalten und löschen: Metadaten, Löschung und Löschbeleg

Veröffentlicht am 11. November 2026

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) oder failed (fehlgeschlagen)
  • completed_at: Zeitpunkt des Abschlusses, null solange noch Dateien entfernt werden
  • manifest_summary.resources: je Datenart die Anzahl vor und nach der Löschung
  • objects_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: Die id gibt es nicht oder sie gehört zu einem anderen Team. Prüfe, ob du versehentlich deine external_identifier statt der id verwendest.
  • Status objects_partial oder failed: Ein Teil der Dateien konnte noch nicht entfernt werden. Vorübergehende Speicherfehler versuchen wir erneut. Bleibt der Status so, wende dich mit der id des Endnutzers an den Support.

War dieser Artikel hilfreich?

Zurück zu Webhooks, Endnutzer & MCP