Kuenta Docs

Appearance

Actualizar el perfil personal del usuario​

PUT
/profile

Actualiza el perfil personal (master) del usuario autenticado.

Headers requeridos

Header Requerido Descripción
Authorization Sí Bearer token JWT
Organization-ID Condicional UUID de la entidad activa. Opcional si el usuario tiene un solo rol.
Configuration-ID Opcional UUID de la configuración de marca blanca. Se resuelve automáticamente por hostname o entidad única.

Sincronización de perfil (MergeFrom)

Cuando se actualiza el perfil master, los cambios se sincronizan al perfil compartido de la marca blanca actual usando merge no destructivo (MergeFrom):

  • Solo se copian campos con valores no vacíos del master al shared
  • Los campos vacíos en el master no sobrescriben datos existentes en el shared
  • Los campos personalizados (customFields) se combinan por nombre, no por posición

Esta estrategia previene pérdida de datos cuando el perfil master está incompleto.

Flujo post-actualización

  1. Se guarda el perfil master en la base de datos
  2. Se sincroniza al perfil compartido de la marca blanca actual (MergeFrom)
  3. Se publica ProfileUpdatedEvent para el perfil compartido
  4. Los handlers crean copias inmutables para créditos en evaluación (no formalizados)

Authorizations​

bearerAuth

JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.

TypeHTTP (bearer)

Parameters​

Header Parameters

Configuration-ID

UUID de la configuración de marca blanca. Recomendado para resolución determinística.
Se resuelve automáticamente por hostname o entidad única si no se envía.

Typestring
formatuuid
Organization-ID

UUID de la entidad activa del usuario. Opcional si el usuario tiene un solo rol.

Typestring
formatuuid

Request Body​

application/json
JSON
"string"

Responses​

Perfil actualizado exitosamente.
application/json
JSON
"string"

Playground​

Server
Authorization
Headers
Body

Samples​

Powered by VitePress OpenAPI