# Wiederherstellungscodes neu generieren

`POST /fapi/v1/me/recovery-codes:regenerate` · wird vom Anmelde-Host der Umgebung aufgerufen

Ersetzt die Wiederherstellungscodes des Benutzers durch neue; alle alten Codes werden ungültig. Die neuen Codes werden in dieser Antwort nur einmal angezeigt, und eine Sicherheitsbenachrichtigung wird an die E-Mail-Adressen des Benutzers gesendet. Erforderlich ist das Cookie `__Host-idp_session` des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird `401 unauthenticated` zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (`Authorization: DPoP <token>` mit einem DPoP-Proof; siehe [Front-API-Zugriffstoken](/docs/api/fapi/front-api-token)).

## Anfrage

Header:

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

Body:

```json
{}
```

## Antwort

`200 OK`:

```json
{"recovery_codes": ["…", "…"]}
```

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie. |
| 401 | `step_up_required` | Die Sitzung wurde nicht in den letzten 5 Minuten verifiziert; verifizieren Sie erneut mit `max_age=300` im Header `WWW-Authenticate`. |
| 403 | `origin_not_allowed` | `Origin` fehlt oder ist falsch. |
| 404 | `not_found` | Wiederherstellungscodes sind in der Umgebung deaktiviert. |
| 409 | `conflict` | Der Benutzer hat keinen zweiten Faktor; Wiederherstellungscodes wurden nicht erzeugt. |

## Beispiel

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/recovery-codes:regenerate \
  -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: Zugangsdaten. [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).