
# Meine Daten exportieren

`POST /fapi/v1/me/exports` · wird vom Anmeldehost der Umgebung aufgerufen

Startet einen Export der eigenen Daten des angemeldeten Benutzers (GDPR Artikel 15 und 20). Das Paket wird im Hintergrund vorbereitet; sobald es bereit ist, erhält der Benutzer eine E-Mail in der Sprache der Anfrage, und die Datei kann 7 Tage lang mit [Export herunterladen](/docs/api/fapi/me/exports/download) heruntergeladen werden.

Das Paket ist eine ZIP-Datei mit einer JSON-Datei pro Datenart: Profil, E-Mail-Adressen und Telefonnummern, verknüpfte Identitäten, Authentifikatoren (ohne Geheimnisse), Sitzungen mit ihren IP-Adressen, Organisationsmitgliedschaften, OAuth-Berechtigungen, Zustimmungen und Anmeldeereignisse. Es enthält niemals einen Passwort-Hash, einen TOTP-Seed, Wiederherstellungscodes, Token oder `app_metadata`.

Erforderlich ist eine aktuelle Anmeldung: Wurde die Sitzung nicht in den letzten 5 Minuten bestätigt oder ist ein zweiter Faktor erforderlich und die Sitzung hat ihn nicht verwendet, lautet die Antwort `401 step_up_required` und nichts wird gestartet. Wird gerade ein Export des Benutzers vorbereitet, wird dieser zurückgegeben und kein neuer gestartet. Ein Benutzer kann höchstens 2 Exporte innerhalb von 24 Stunden anfordern.

## Anfrage

Header:

| Header | Erforderlich | Beschreibung |
| --- | --- | --- |
| `Idp-Client` | ja | SDK-Kennung. |
| `Origin` | ja | Muss genau `https://<sign-in host>` sein. |

Inhalt:

```json
{}
```

## Antwort

`202 Accepted`:

```json
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
 "created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
```

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie. |
| 401 | `step_up_required` | Anmeldung älter als 5 Minuten oder ein zweiter Faktor ist erforderlich; der Header `WWW-Authenticate` enthält `max_age=300` (und `acr_values`, wenn ein zweiter Faktor erforderlich ist). |
| 403 | `origin_not_allowed` | `Origin` fehlt oder ist falsch. |
| 429 | `export_rate_limited` | Zwei Exporte wurden in den letzten 24 Stunden bereits angefordert; erneut versuchen nach `Retry-After`. |
| 429 | `rate_limited` | Zu viele Exporte werden in der Umgebung gerade vorbereitet; erneut versuchen nach `Retry-After`. |
| 503 | `service_unavailable` | Das Benutzerverzeichnis ist vorübergehend nicht verfügbar; erneut versuchen nach `Retry-After`. |

## Beispiel

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/json" \
  -d '{}' \
  -b cookies.txt
```

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Datenschutzanfragen (die eigenen Exportdatensätze des Benutzers). [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).
