
# Renommer une clé d'accès

`PATCH /fapi/v1/me/passkeys/{authenticator_id}` · appelé depuis l'hôte de connexion de l'environnement

Modifie le nom d'affichage donné par l'utilisateur à un enregistrement de clé d'accès. Nécessite le cookie `__Host-idp_session` de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie `401 unauthenticated`. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API frontale (`Authorization: DPoP <token>` avec une preuve DPoP ; voir [Jeton d'accès à l'API frontale](/docs/api/fapi/front-api-token)).

## Requête

En-têtes :

| En-tête | Obligatoire | Description |
| --- | --- | --- |
| `Idp-Client` | oui | Identifiant du SDK. |
| `Origin` | oui | Doit être exactement `https://<hôte de connexion>`. |

Corps :

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

`label` est obligatoire ; il ne peut contenir ni caractères de contrôle ni marqueurs directionnels.

## Réponse

`204 No Content`.

## Erreurs

| Statut | Code | Quand |
| --- | --- | --- |
| 422 | `validation_failed` | `label` est absent. |
| 422 | `invalid_display_string` | `label` ne respecte pas les règles relatives au nom d'affichage. |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 403 | `origin_not_allowed` | `Origin` est absent ou incorrect. |
| 404 | `not_found` | Aucune clé d'accès ou clé de sécurité de cet utilisateur ne correspond. |

## Exemple

```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
```

## Données personnelles

Cet point de terminaison traite des données personnelles : des identifiants. [Données personnelles dans les API KeenAuth](/docs/policies/personal-data) décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de données personnelles sensibles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.
