Skip to main content
POST
Actualizar un monitor

Autorizaciones

pubrio-api-key
string
header
requerido

Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.

Cuerpo

application/json
monitor_id
string<uuid>
requerido

Identificador único del monitor que se va a actualizar.

name
string

Nombre del monitor.

description
string

Descripción del monitor.

detection_mode
enum<string>

Cómo se detectan las señales. signal_first explora el mercado de forma amplia; company_first hace seguimiento de una lista de cuentas específica y requiere al menos una empresa, dominio o URL de LinkedIn. Inmutable después de la creación: cambiarlo en un monitor existente devuelve 40021. Crea un nuevo monitor en su lugar.

Opciones disponibles:
company_first,
signal_first
signal_types
enum<string>[]

Tipos de señales a monitorear.

Opciones disponibles:
jobs,
news,
advertisements,
expansions,
cloud_footprints
signal_filters
object[]

Una entrada por cada flujo de señales que supervisa el monitor.

Ejemplo:
company_filters
object

Filtros de empresa globales aplicados como una segunda capa en todos los tipos de señales. Acepta los mismos parámetros que el endpoint Company Search: ubicaciones, empleados, tecnologías, verticales y más.

Ejemplo:
companies
string<uuid>[]

Lista de UUID de domain_search_id de empresa. Alternativa: usa domains o linkedin_urls.

domains
string[]

Lista de dominios de empresa. Alternativa a companies.

linkedin_urls
string<uri>[]

Lista de URL de empresa de LinkedIn. Alternativa a companies.

is_company_enrichment
boolean

Si se debe enriquecer los datos de la empresa.

is_people_enrichment
boolean

Si se debe enriquecer los datos de personas.

people_enrichment_configs
object[]

Arreglo de capas de enriquecimiento de personas. Cada capa ejecuta una búsqueda de personas independiente. Contiene max_people_to_return (1-25), people_contact_types (arreglo; hace referencia a los tipos de contacto de Redeem: email-work, email-personal, phone) y filters (los mismos parámetros que el endpoint People Search).

Ejemplo:
destination_type
enum<string>

Tipo de destino de entrega.

Opciones disponibles:
webhook,
email,
sequences
destination_config
object

Configuración del destino. Para webhook: requiere webhook_url (cadena), y opcionalmente headers (objeto) y body (objeto). Para email: acepta email (cadena) o emails (arreglo de cadenas). Para secuencias: requiere sequence_identifier (cadena) además de al menos uno de is_people_search_enrolled / is_company_contact_enrolled establecido en true.

Ejemplo:
frequency_minute
integer

Frecuencia de activación en minutos. Mín.: 0, Máx.: 10080, Predeterminado: 0.

Rango requerido: 0 <= x <= 10080
max_failure_trigger
integer

Número máximo de fallos consecutivos antes de pausar. Mín.: 1, Máx.: 10, Predeterminado: 5.

Rango requerido: 1 <= x <= 10
max_daily_trigger
integer

Número máximo de activaciones por día. Mín.: 0, Máx.: 86400, Predeterminado: 500.

Rango requerido: 0 <= x <= 86400
max_records_per_trigger
integer

Controla el número máximo de registros entregados por activación. Los valores más bajos reducen el tamaño de la carga útil por entrega, lo cual se recomienda para conjuntos de resultados grandes o integraciones con límite de tasa. Mín.: 1, Máx.: 100, Predeterminado: 25. Consulta Setting up Webhooks para más orientación.

Rango requerido: 1 <= x <= 100
excluded_companies
string[]

Empresas que este monitor nunca entrega ni factura, como UUID domain_search_id. Se aplica en ambos modos de detección en tiempo de ejecución, antes del enriquecimiento y la facturación; una empresa presente en companies y en esta lista queda excluida mientras siga en la lista. Tamaño máximo: 100.000 (ids resueltos entre excluded_companies, excluded_domains y excluded_linkedin_urls).

Ejemplo:
excluded_domains
string[]

Dominios de empresa a excluir (p. ej. ["existing-client.com"]). Se resuelven a empresas y se fusionan en excluded_companies.

Ejemplo:
excluded_linkedin_urls
string[]

URLs de empresa de LinkedIn a excluir. Se resuelven a empresas y se fusionan en excluded_companies.

Ejemplo:
companies_mode
enum<string>

Cómo se aplican los companies / domains / linkedin_urls enviados a la lista de seguimiento guardada: replace (por defecto) sustituye toda la lista, add añade las empresas enviadas, remove las quita. Las listas que omites no se tocan.

Opciones disponibles:
replace,
add,
remove
Ejemplo:

"add"

excluded_companies_mode
enum<string>

Lo mismo para la lista de exclusión (excluded_companies / excluded_domains / excluded_linkedin_urls): replace (por defecto), add o remove.

Opciones disponibles:
replace,
add,
remove
Ejemplo:

"add"

record_unit
enum<string>

Qué es un registro entregado: signal (payload signals[], una entrada por señal) o company (payload companies[], una entrada por empresa con sus señales anidadas). Por defecto sigue a detection_mode: signal_first → signal, company_first → company. Los límites (max_records_per_trigger, max_daily_records) cuentan esta unidad.

Opciones disponibles:
signal,
company
Ejemplo:

"company"

company_dedupe_days
integer

Una empresa aparece como máximo en una entrega cada tantos días, en todos los tipos de señal del monitor; una empresa entregada dentro de la ventana queda fuera de las entregas posteriores y sus señales posteriores dentro de la ventana se omiten, no se encolan. 0 = desactivado. Por defecto: 0.

Rango requerido: x >= 0
Ejemplo:

30

is_newest_first
boolean

Entregar primero las señales coincidentes más recientes. Con un tope por disparo o diario se conservan los registros más nuevos y el cursor del monitor avanza igualmente hasta la fila más nueva obtenida, así que las filas antiguas se omiten, nunca se encolan. Por defecto false (las más antiguas primero, sin omitir nada).

Ejemplo:

true

max_daily_records
integer

Límite estricto de registros entregados por día natural en la zona horaria del propietario (0 = sin límite). Se cuenta en la unidad de registro del monitor sobre entregas exitosas; un disparo entrega como máximo el presupuesto restante y luego el monitor espera al día siguiente sin mover su cursor. Por defecto: 0.

Rango requerido: x >= 0
Ejemplo:

200

notification_email
string<email>

Correo electrónico para notificaciones de fallos.

max_retry_per_trigger
integer

Número máximo de reintentos por activación. Mín.: 0, Máx.: 3, Predeterminado: 1.

Rango requerido: 0 <= x <= 3
retry_delay_second
integer

Retraso entre reintentos en segundos. Mín.: 1, Máx.: 5, Predeterminado: 1.

Rango requerido: 1 <= x <= 5
status
enum<string>

Estado del ciclo de vida a establecer. Cambiar el estado reinicia el contador de fallos.

Opciones disponibles:
draft,
active,
paused,
inactive

Respuesta

Respuesta correcta que contiene el monitor actualizado. La respuesta siempre incluye monitor_id, name, detection_mode, destination_type, status, masked_signature y last_modified, además de cualquier otra columna que formara parte de la actualización.

metadata
object
data
object

El monitor actualizado. También se devuelve cualquier otra columna incluida en la actualización.

Última modificación el 4 de septiembre de 2026