Skip to main content
POST
Actualizar entidad (refresh)

Descripción

Re-ejecuta enrichments del marketplace para una persona o empresa existente, opcionalmente:
  • Actualiza el nombre y/o entityData (solo si lo indicás con los nuevos flags)
  • Crea o re-enriquece socios (empresas, depth > 0)
  • Ejecuta el motor de reglas al finalizar
Equivalente programático al refresh completo del panel (Risk Matrix) o al refresh solo datos básicos del Entity Builder.
Retrocompatibilidad: Si omitís refreshScope, preserveName y preserveEntityData, el comportamiento es el de siempre: la selección de proveedores sigue autoExecuteIntegrations y el nombre se sincroniza desde fullName normalizado cuando cambia. entityData no se modifica salvo refreshScope: "basic_data" con preserveEntityData.

Endpoint

Autenticación

Requiere permiso para ejecutar enrichments (igual que POST /entities/{entityId}/enrich).

Parámetros de ruta

string
required
UUID de la entidad a actualizar.

Cuerpo

boolean
default:"true"
Si es true, omite caché y vuelve a llamar a los proveedores.
boolean
default:"false"
Si es true, no ejecuta reglas después del enrichment.
integer
default:"1"
Profundidad de socios (0–5). Ignorado con refreshScope: "basic_data" (siempre 0).
object
Selección legacy de proveedores (cuando refreshScope se omite). Misma forma que POST /entities/automatic.
object
Pipeline de socios (empresas, depth > 0). Misma forma que creación automática.
string
Scope unificado opcional. Si está presente, reemplaza autoExecuteIntegrations en la entidad raíz:
array
Obligatorio cuando refreshScope es selected.
boolean
  • true: conservar el nombre actual.
  • false: sincronizar desde mapeo (basic_data) o fullName normalizado.
  • Omitido (legacy): sincronizar nombre si fullName cambió (comportamiento anterior).
boolean
Solo con refreshScope: "basic_data" y enrichment exitoso:
  • Omitido: no tocar entityData.
  • true: completar solo campos vacíos (gap-fill).
  • false: reemplazar entityData desde datos básicos.
Sin efecto en all_active, selected o bodies legacy sin basic_data.

Ejemplos

Refresh legacy (sin cambios)

Solo datos básicos (seguro)

Respuesta

Incluye data.entity, data.enrichmentResult, contadores de socios y errors. Con skipRulesEngine: false, también rulesExecutionSummary en la raíz (igual que Analyze).

Eventos Socket.IO

entity:refresh-started, entity:refreshed, entity:refresh-failed.

Endpoints relacionados

Analyze

Motor de reglas (enrichment opcional).

Materializar relaciones

Cadena de socios desde normalized.