
# Passkey umbenennen

`PATCH /fapi/v1/me/passkeys/{authenticator_id}` · wird vom Sign-in-Host der Umgebung aufgerufen

Ändert den Anzeigenamen, den der Benutzer einem Passkey-Datensatz gegeben hat. Erforderlich ist das Cookie `__Host-idp_session` des angemeldeten Benutzers. Fehlt das Cookie, ist es abgelaufen oder widerrufen, gibt der Endpunkt `401 unauthenticated` zurück. 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 exakt `https://<sign-in host>` sein. |

Body:

```json
{"label": "Work laptop"}
```

`label` ist erforderlich; er darf keine Steuerzeichen oder Richtungsmarkierungen enthalten.

## Antwort

`204 No Content`.

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 422 | `validation_failed` | `label` fehlt. |
| 422 | `invalid_display_string` | `label` entspricht nicht den Regeln für Anzeigenamen. |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie. |
| 403 | `origin_not_allowed` | `Origin` fehlt oder ist falsch. |
| 404 | `not_found` | Für diesen Benutzer gibt es keinen solchen Passkey oder Sicherheitsschlüssel. |

## Beispiel

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

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Anmeldedaten. [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 keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in einem Feld.
