Obtener la configuración de identidad

GET /v1/identity-settings · permiso identity-settings:read

Devuelve la configuración de nombre de usuario del entorno (un recurso por entorno). Si la configuración nunca se escribió, se devuelven los valores predeterminados de la tabla (username_identifier: off, 3 a 64 caracteres, lista reservada vacía) con ETag: "0" y updated_at: null. El encabezado de respuesta ETag lleva la versión a enviar como If-Match en PATCH.

verification_policy (before_sign_in de forma predeterminada) y unverified_account_ttl_days (7 de forma predeterminada) controlan la limpieza de cuentas no verificadas; consulte Actualizar la configuración de identidad.

Solicitud

Esta operación no recibe campos de ruta, consulta ni cuerpo. El entorno proviene de la credencial.

Respuesta

200 OK con la configuración y el encabezado ETag.

{
  "username_identifier": "optional",
  "username_min_length": 3,
  "username_max_length": 32,
  "reserved_usernames": ["admin", "root", "support"],
  "verification_policy": "before_sign_in",
  "unverified_account_ttl_days": 7,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Errores

HTTP	código	Cuándo
401	`unauthenticated`	La credencial falta, es inválida o ha sido revocada.
403	`insufficient_permissions`	La credencial carece del permiso requerido.
429	`rate_limited`	Se superó el límite de velocidad; reintente después del período `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente después del período `Retry-After`.

Ejemplo

curl https://api.eu.keenauth.com/v1/identity-settings \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"