# Rinomina un autenticatore

`PATCH /fapi/v1/me/authenticators/{authenticator_id}` · chiamato dall'host di accesso dell'ambiente

Modifica il nome visualizzato che l'utente ha assegnato a un record di autenticatore. Richiede il cookie `__Host-idp_session` dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce `401 unauthenticated`. Un'app first-party su un'altra origine può invece inviare il proprio token di accesso per la front API (`Authorization: DPoP <token>` con una proof DPoP; vedi [Token di accesso per la front API](/docs/api/fapi/front-api-token)).

## Richiesta

Header:

| Header | Obbligatorio | Descrizione |
| --- | --- | --- |
| `Idp-Client` | sì | Identificatore dell'SDK. |
| `Origin` | sì | Deve essere esattamente `https://<sign-in host>`. |

Body:

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

`label` è obbligatorio; non può contenere caratteri di controllo o marcatori di direzionalità.

## Risposta

`204 No Content`.

## Errori

| Stato | Codice | Quando |
| --- | --- | --- |
| 422 | `validation_failed` | `label` mancante. |
| 422 | `invalid_display_string` | `label` non rispetta le regole per il nome visualizzato. |
| 401 | `unauthenticated` | Nessun cookie di sessione valido. |
| 403 | `origin_not_allowed` | `Origin` manca oppure è errato. |
| 404 | `not_found` | Nessun autenticatore di questo tipo per questo utente. |

## Esempio

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

## Dati personali

Questo endpoint tratta dati personali: credenziali. [Dati personali nelle API di KeenAuth](/docs/policies/personal-data) descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene eliminato. Non inviare in nessun campo categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale).