> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar monitor

> Actualiza la configuración y las reglas de detección de un monitor existente.



## OpenAPI

````yaml es-openapi POST /monitors/update
openapi: 3.0.0
info:
  description: >-
    La API de Pubrio ofrece inteligencia de expansión de mercado —señales en
    tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto
    con los datos de empresas y personas que las respaldan. Busca, consulta y
    enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas
    y fechadas en más de 200 mercados.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/es/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/es/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: Información del perfil del espacio de trabajo y estadísticas de uso
  - name: Enrichment
    description: Enriquece registros de personas y empresas con datos B2B detallados
  - name: Lookalike
    description: Encuentra empresas similares a una empresa determinada
  - name: Search
    description: Busca personas, empresas, empleos, noticias y anuncios con filtros
  - name: Lookup
    description: >-
      Consulta información detallada de personas, empresas, empleos, noticias,
      anuncios y tecnologías específicos
  - name: LinkedIn
    description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn
  - name: Redeem
    description: >-
      Canjea créditos para desbloquear datos de contacto de personas (individual
      y por lotes)
  - name: Channels
    description: >-
      Gestiona plantillas de canales de contacto (crear, actualizar, eliminar,
      listar)
  - name: Monitor
    description: >-
      Crea y gestiona monitores de datos con webhooks, estadísticas y
      procesamiento
  - name: Filters
    description: >-
      Obtén los valores de filtro disponibles para los parámetros de búsqueda
      (tecnologías, ubicaciones, verticales, etc.)
  - name: API Keys
    description: >-
      Lista e inspecciona los registros de solicitudes a la API y las analíticas
      de uso de las claves de API
  - name: Insights
    description: >-
      Información agregada de señales para empresas (empleos, noticias,
      anuncios).
  - name: Export
    description: Exportaciones de datos masivas (sujetas a créditos).
  - name: Expansion
    description: >-
      Inteligencia de expansión de mercado de empresas: señales, etapas,
      mercados y exportaciones.
externalDocs:
  description: >-
    La API de Pubrio se utiliza para buscar, previsualizar y enriquecer
    contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de
    contactos B2B e inteligencia de ventas.
  url: https://docs.pubrio.com
paths:
  /monitors/update:
    post:
      tags:
        - Monitor
      summary: Actualizar un monitor
      description: >-
        Actualiza la configuración y las reglas de detección de un monitor
        existente.
      operationId: monitors_update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: Identificador único del monitor que se va a actualizar.
                name:
                  type: string
                  description: Nombre del monitor.
                description:
                  type: string
                  description: Descripción del monitor.
                detection_mode:
                  type: string
                  description: >-
                    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.
                  enum:
                    - company_first
                    - signal_first
                signal_types:
                  type: array
                  items:
                    type: string
                    enum:
                      - jobs
                      - news
                      - advertisements
                      - expansions
                  description: Tipos de señales a monitorear.
                signal_filters:
                  type: array
                  items:
                    type: object
                    required:
                      - signal_type
                    properties:
                      signal_type:
                        type: string
                        enum:
                          - jobs
                          - news
                          - advertisements
                          - expansions
                        description: Qué flujo filtra esta entrada.
                      filters:
                        type: object
                        description: >-
                          Filtros para este flujo. `jobs`, `news` y
                          `advertisements` toman los parámetros de [Job
                          Search](/es/api-reference/endpoint/companies/job_search),
                          [News
                          Search](/es/api-reference/endpoint/companies/news_search)
                          y [Advertisement
                          Search](/es/api-reference/endpoint/companies/advertisements_search).
                          `expansions` toma el vocabulario de [Expansion
                          Search](/es/api-reference/endpoint/expansions/market_lookup):
                          `froms` / `tos`, `window_days`, `stages`, `scopes`,
                          `momentum`, `freshness`, `signal_types`,
                          `signal_subtypes`, `signal_strengths`, `source_types`.
                          Resuelve los slugs desde [Expansion
                          Reference](/es/api-reference/endpoint/expansions/types).
                  description: >-
                    Una entrada por cada flujo de señales que supervisa el
                    monitor.
                  example:
                    - signal_type: jobs
                      filters:
                        locations:
                          - US
                    - signal_type: news
                      filters:
                        locations:
                          - US
                    - signal_type: advertisements
                      filters:
                        target_locations:
                          - US
                    - signal_type: expansions
                      filters:
                        tos:
                          - US
                        stages:
                          - expanding
                          - scaling
                        signal_types:
                          - HIRE
                          - EXEC
                        signal_strengths:
                          - high
                          - very_high
                company_filters:
                  type: object
                  description: >-
                    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](/es/api-reference/endpoint/companies/search):
                    ubicaciones, empleados, tecnologías, verticales y más.
                  example:
                    locations:
                      - US
                    employees:
                      - - 501
                        - 1000
                      - - 1001
                        - 5000
                companies:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: >-
                    Lista de UUID de domain_search_id de empresa. Alternativa:
                    usa `domains` o `linkedin_urls`.
                domains:
                  type: array
                  items:
                    type: string
                  description: Lista de dominios de empresa. Alternativa a `companies`.
                linkedin_urls:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: >-
                    Lista de URL de empresa de LinkedIn. Alternativa a
                    `companies`.
                is_company_enrichment:
                  type: boolean
                  description: Si se debe enriquecer los datos de la empresa.
                is_people_enrichment:
                  type: boolean
                  description: Si se debe enriquecer los datos de personas.
                people_enrichment_configs:
                  type: array
                  items:
                    type: object
                  description: >-
                    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](/es/api-reference/endpoint/redeem/people):
                    email-work, email-personal, phone) y `filters` (los mismos
                    parámetros que el endpoint [People
                    Search](/es/api-reference/endpoint/people/search)).
                  example:
                    - filters:
                        people_locations:
                          - US
                      max_people_to_return: 3
                      people_contact_types:
                        - email-work
                destination_type:
                  type: string
                  description: Tipo de destino de entrega.
                  enum:
                    - webhook
                    - email
                    - sequences
                destination_config:
                  type: object
                  description: >-
                    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.
                  example:
                    webhook_url: https://your-webhook.com/endpoint
                    headers:
                      Authorization: Bearer token
                    body:
                      pipeline: my-webhook
                frequency_minute:
                  type: integer
                  description: >-
                    Frecuencia de activación en minutos. Mín.: 0, Máx.: 10080,
                    Predeterminado: 0.
                  minimum: 0
                  maximum: 10080
                max_failure_trigger:
                  type: integer
                  description: >-
                    Número máximo de fallos consecutivos antes de pausar. Mín.:
                    1, Máx.: 10, Predeterminado: 5.
                  minimum: 1
                  maximum: 10
                max_daily_trigger:
                  type: integer
                  description: >-
                    Número máximo de activaciones por día. Mín.: 0, Máx.: 86400,
                    Predeterminado: 500.
                  minimum: 0
                  maximum: 86400
                max_records_per_trigger:
                  type: integer
                  description: >-
                    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](/es/developer-guides/setting-up-webhooks) para más
                    orientación.
                  minimum: 1
                  maximum: 100
                notification_email:
                  type: string
                  format: email
                  description: Correo electrónico para notificaciones de fallos.
                max_retry_per_trigger:
                  type: integer
                  description: >-
                    Número máximo de reintentos por activación. Mín.: 0, Máx.:
                    3, Predeterminado: 1.
                  minimum: 0
                  maximum: 3
                retry_delay_second:
                  type: integer
                  description: >-
                    Retraso entre reintentos en segundos. Mín.: 1, Máx.: 5,
                    Predeterminado: 1.
                  minimum: 1
                  maximum: 5
                status:
                  type: string
                  enum:
                    - draft
                    - active
                    - paused
                    - inactive
                  description: >-
                    Estado del ciclo de vida a establecer. Cambiar el estado
                    reinicia el contador de fallos.
              required:
                - monitor_id
      responses:
        '200':
          description: >-
            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.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      monitor_id:
                        type: string
                        format: uuid
                        description: Identificador único del monitor.
                      name:
                        type: string
                        description: Nombre del monitor.
                      detection_mode:
                        type: string
                        description: Modo de detección.
                      destination_type:
                        type: string
                        description: Tipo de destino de entrega.
                      status:
                        type: string
                        enum:
                          - draft
                          - active
                          - paused
                          - inactive
                        description: Estado del ciclo de vida del monitor.
                      masked_signature:
                        type: string
                        description: Firma de webhook enmascarada.
                      last_modified:
                        type: string
                        format: date-time
                        description: Marca de tiempo de la última modificación del monitor.
                    description: >-
                      El monitor actualizado. También se devuelve cualquier otra
                      columna incluida en la actualización.
              example:
                data:
                  monitor_id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                  name: Updated Monitor Name
                  detection_mode: company_first
                  destination_type: webhook
                  status: active
                  masked_signature: 9••••••••••••••••f09
                  last_modified: '2026-04-05T21:00:00.000Z'
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  responses:
    general_error:
      description: >-
        Solicitud incorrecta. La solicitud estaba mal formada o contenía
        parámetros no válidos. Consulta el código de error y el mensaje para más
        detalles.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Límite de tasa excedido. Se realizaron demasiadas solicitudes en un
        período de tiempo determinado. Vuelve a intentarlo después de que se
        restablezca la ventana de límite de tasa.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Error interno del servidor. Se produjo un error inesperado en el
        servidor. Contacta con soporte si el error persiste.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        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](https://dashboard.pubrio.com/#/settings/).
      in: header

````