Renombrar un autenticador
PATCH /fapi/v1/me/authenticators/{authenticator_id} · llamado desde el host de inicio de sesión del entorno
Cambia el nombre para mostrar que el usuario asignó a un registro de autenticador. Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha expirado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación de primera parte en otro origen puede enviar en su lugar su token de acceso a la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API frontal).
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí | Debe ser exactamente https://<sign-in host>. |
Cuerpo:
{"label": "Work laptop"}
label es obligatorio; no puede contener caracteres de control ni marcadores direccionales.
Respuesta
204 No Content.
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 422 | validation_failed |
Falta label. |
| 422 | invalid_display_string |
label no cumple las reglas de nombres para mostrar. |
| 401 | unauthenticated |
No hay una cookie de sesión válida. |
| 403 | origin_not_allowed |
Falta Origin o es incorrecto. |
| 404 | not_found |
No existe ese autenticador para este usuario. |
Ejemplo
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
Datos personales
Este endpoint maneja datos personales: credenciales. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe datos personales de categorías especiales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.