> ## 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. # Atualizar Monitor > Atualiza a configuração e as regras de detecção de um monitor existente. ## OpenAPI ````yaml pt-openapi POST /monitors/update openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/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: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /monitors/update: post: tags: - Monitor summary: Atualizar um monitor description: Atualiza a configuração e as regras de detecção de um 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 do monitor a atualizar. name: type: string description: Nome do monitor. description: type: string description: Descrição do monitor. detection_mode: type: string description: >- Como os sinais são detectados. `signal_first` varre o mercado de forma ampla; `company_first` acompanha uma lista de contas nomeadas e exige ao menos uma empresa, domínio ou URL do LinkedIn. **Imutável após a criação** — alterá-lo em um monitor existente retorna `40021`. Crie um novo monitor em vez disso. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: Tipos de sinais a monitorar. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: Qual fluxo esta entrada filtra. filters: type: object description: >- Filtros para este fluxo. `jobs`, `news` e `advertisements` recebem os parâmetros de [Job Search](/pt/api-reference/endpoint/companies/job_search), [News Search](/pt/api-reference/endpoint/companies/news_search) e [Advertisement Search](/pt/api-reference/endpoint/companies/advertisements_search). `expansions` recebe o vocabulário de [Expansion Search](/pt/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Resolva os slugs em [Expansion Reference](/pt/api-reference/endpoint/expansions/types). description: Uma entrada por fluxo de sinal que o monitor observa. 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 globais de empresa aplicados como uma segunda camada em todos os tipos de sinal. Aceita os mesmos parâmetros do endpoint [Company Search](/pt/api-reference/endpoint/companies/search) — localizações, número de funcionários, tecnologias, verticais e mais. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- Lista de UUIDs de domain_search_id de empresas. Alternativa: use `domains` ou `linkedin_urls`. domains: type: array items: type: string description: Lista de domínios de empresas. Alternativa a `companies`. linkedin_urls: type: array items: type: string format: uri description: >- Lista de URLs de empresas no LinkedIn. Alternativa a `companies`. is_company_enrichment: type: boolean description: Se deve enriquecer dados de empresa. is_people_enrichment: type: boolean description: Se deve enriquecer dados de pessoas. people_enrichment_configs: type: array items: type: object description: >- Array de camadas de enriquecimento de pessoas. Cada camada executa uma busca de pessoas independente. Contém `max_people_to_return` (1-25), `people_contact_types` (array — refere-se aos tipos de contato de [Redeem](/pt/api-reference/endpoint/redeem/people): email-work, email-personal, phone) e `filters` (mesmos parâmetros do endpoint [People Search](/pt/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: >- Configuração do destino. Para webhook: exige `webhook_url` (string), com `headers` (objeto) e `body` (objeto) opcionais. Para email: aceita `email` (string) ou `emails` (array de strings). Para sequences: exige `sequence_identifier` (string) mais ao menos um de `is_people_search_enrolled` / `is_company_contact_enrolled` definido como true. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: >- Frequência de acionamento em minutos. Mín: 0, Máx: 10080, Padrão: 0. minimum: 0 maximum: 10080 max_failure_trigger: type: integer description: >- Número máximo de falhas consecutivas antes de pausar. Mín: 1, Máx: 10, Padrão: 5. minimum: 1 maximum: 10 max_daily_trigger: type: integer description: >- Número máximo de acionamentos por dia. Mín: 0, Máx: 86400, Padrão: 500. minimum: 0 maximum: 86400 max_records_per_trigger: type: integer description: >- Controla o número máximo de registros entregues por acionamento. Valores menores reduzem o tamanho do payload por entrega, o que é recomendado para conjuntos de resultados grandes ou integrações com limite de taxa. Mín: 1, Máx: 100, Padrão: 25. Veja [Setting up Webhooks](/pt/developer-guides/setting-up-webhooks) para orientações. minimum: 1 maximum: 100 notification_email: type: string format: email description: E-mail para notificações de falha. max_retry_per_trigger: type: integer description: >- Número máximo de novas tentativas por acionamento. Mín: 0, Máx: 3, Padrão: 1. minimum: 0 maximum: 3 retry_delay_second: type: integer description: >- Intervalo entre novas tentativas, em segundos. Mín: 1, Máx: 5, Padrão: 1. minimum: 1 maximum: 5 status: type: string enum: - draft - active - paused - inactive description: >- Status do ciclo de vida a definir. Alterar o status reinicia o contador de falhas. required: - monitor_id responses: '200': description: >- Resposta bem-sucedida contendo o monitor atualizado. A resposta sempre inclui monitor_id, name, detection_mode, destination_type, status, masked_signature e last_modified, além de quaisquer outras colunas que faziam parte da atualização. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: Identificador único do monitor. name: type: string description: Nome do monitor. detection_mode: type: string description: Modo de detecção. destination_type: type: string description: Tipo de destino de entrega. status: type: string enum: - draft - active - paused - inactive description: Status do ciclo de vida do monitor. masked_signature: type: string description: Assinatura de webhook mascarada. last_modified: type: string format: date-time description: Timestamp da última modificação do monitor. description: >- O monitor atualizado. Quaisquer outras colunas incluídas na atualização também são retornadas. 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: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````