# Renommer un authentificateur

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

Modifie le nom d'affichage que l'utilisateur a donné à un enregistrement d'authentificateur. 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 envoyer à la place son jeton d'accès à l'API front (`Authorization: DPoP <token>` avec une preuve DPoP ; voir [Jeton d'accès à l'API front](/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 pas contenir de caractères de contrôle ni de 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 aux noms d'affichage. |
| 401 | `unauthenticated` | Aucun cookie de session valide. |
| 403 | `origin_not_allowed` | `Origin` est absent ou incorrect. |
| 404 | `not_found` | Aucun authentificateur de ce type pour cet utilisateur. |

## Exemple

```bash
curl -X PATCH https://example.keenauth.app/fapi/v1/me/authenticators/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

Ce 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é, pendant combien de temps les données sont conservées et comment elles sont supprimées. Ne transmettez dans aucun champ de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle).