> ## 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.

# Mettre à jour un moniteur

> Mettez à jour la configuration et les règles de détection d'un moniteur existant.



## OpenAPI

````yaml fr-openapi POST /monitors/update
openapi: 3.0.0
info:
  description: >-
    L'API Pubrio fournit une intelligence d'expansion de marché — des signaux en
    temps réel qui indiquent quand une entreprise entre sur un nouveau marché —
    ainsi que les données d'entreprises et de personnes qui les sous-tendent.
    Recherchez, consultez et enrichissez des comptes et des contacts, et
    abonnez-vous à des signaux de mouvement typés et datés sur plus de 200
    marchés.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/fr/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/fr/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: >-
      Informations de profil de l'espace de travail et statistiques
      d'utilisation
  - name: Enrichment
    description: >-
      Enrichissez les fiches de personnes et d'entreprises avec des données B2B
      détaillées
  - name: Lookalike
    description: Trouvez des entreprises similaires à une entreprise donnée
  - name: Search
    description: >-
      Recherchez des personnes, des entreprises, des offres d'emploi, des
      actualités et des publicités à l'aide de filtres
  - name: Lookup
    description: >-
      Consultez des informations détaillées sur des personnes, entreprises,
      offres d'emploi, actualités, publicités et technologies spécifiques
  - name: LinkedIn
    description: >-
      Consultez les données de personnes et d'entreprises via des URL de profil
      LinkedIn
  - name: Redeem
    description: >-
      Utilisez des crédits pour débloquer les coordonnées de personnes (unitaire
      et par lot)
  - name: Channels
    description: >-
      Gérez les modèles de canaux de prospection (création, mise à jour,
      suppression, liste)
  - name: Monitor
    description: >-
      Créez et gérez des moniteurs de données avec webhooks, statistiques et
      traitement
  - name: Filters
    description: >-
      Récupérez les valeurs de filtre disponibles pour les paramètres de
      recherche (technologies, localisations, secteurs verticaux, etc.)
  - name: API Keys
    description: >-
      Listez et inspectez les journaux de requêtes API et les statistiques
      d'utilisation des clés API
  - name: Insights
    description: >-
      Informations agrégées sur les signaux des entreprises (offres d'emploi,
      actualités, publicités).
  - name: Export
    description: Exports de données en masse (soumis à des crédits).
  - name: Expansion
    description: >-
      Intelligence d'expansion de marché des entreprises : signaux, étapes,
      marchés et exports.
externalDocs:
  description: >-
    L'API Pubrio permet de rechercher, prévisualiser et enrichir des contacts et
    des comptes. La base de données Pubrio fournit des données étendues de
    contacts B2B et de veille commerciale.
  url: https://docs.pubrio.com
paths:
  /monitors/update:
    post:
      tags:
        - Monitor
      summary: Mettre à jour un moniteur
      description: >-
        Mettez à jour la configuration et les règles de détection d'un moniteur
        existant.
      operationId: monitors_update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: Identifiant unique du moniteur à mettre à jour.
                name:
                  type: string
                  description: Nom du moniteur.
                description:
                  type: string
                  description: Description du moniteur.
                detection_mode:
                  type: string
                  description: >-
                    Mode de détection des signaux. `signal_first` scanne
                    largement le marché ; `company_first` suit une liste de
                    comptes nommés et nécessite au moins une entreprise, un
                    domaine ou une URL LinkedIn. **Immuable après création** —
                    sa modification sur un moniteur existant renvoie `40021`.
                    Créez plutôt un nouveau moniteur.
                  enum:
                    - company_first
                    - signal_first
                signal_types:
                  type: array
                  items:
                    type: string
                    enum:
                      - jobs
                      - news
                      - advertisements
                      - expansions
                  description: Types de signaux à surveiller.
                signal_filters:
                  type: array
                  items:
                    type: object
                    required:
                      - signal_type
                    properties:
                      signal_type:
                        type: string
                        enum:
                          - jobs
                          - news
                          - advertisements
                          - expansions
                        description: Le flux que cette entrée filtre.
                      filters:
                        type: object
                        description: >-
                          Filtres pour ce flux. `jobs`, `news` et
                          `advertisements` reprennent les paramètres de
                          [Recherche d'offres
                          d'emploi](/fr/api-reference/endpoint/companies/job_search),
                          [Recherche
                          d'actualités](/fr/api-reference/endpoint/companies/news_search)
                          et [Recherche de
                          publicités](/fr/api-reference/endpoint/companies/advertisements_search).
                          `expansions` reprend le vocabulaire de [Recherche
                          d'expansion](/fr/api-reference/endpoint/expansions/market_lookup)
                          : `froms` / `tos`, `window_days`, `stages`, `scopes`,
                          `momentum`, `freshness`, `signal_types`,
                          `signal_subtypes`, `signal_strengths`, `source_types`.
                          Résolvez les slugs à partir de [Référence
                          d'expansion](/fr/api-reference/endpoint/expansions/types).
                  description: Une entrée par flux de signal surveillé par le moniteur.
                  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: >-
                    Filtres d'entreprise globaux appliqués comme second niveau à
                    tous les types de signaux. Accepte les mêmes paramètres que
                    le point de terminaison [Recherche
                    d'entreprises](/fr/api-reference/endpoint/companies/search)
                    — localisations, effectifs, technologies, secteurs
                    verticaux, etc.
                  example:
                    locations:
                      - US
                    employees:
                      - - 501
                        - 1000
                      - - 1001
                        - 5000
                companies:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: >-
                    Liste d'UUID domain_search_id d'entreprise. Alternative :
                    utilisez `domains` ou `linkedin_urls`.
                domains:
                  type: array
                  items:
                    type: string
                  description: Liste de domaines d'entreprise. Alternative à `companies`.
                linkedin_urls:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: >-
                    Liste d'URL LinkedIn d'entreprise. Alternative à
                    `companies`.
                is_company_enrichment:
                  type: boolean
                  description: Indique s'il faut enrichir les données d'entreprise.
                is_people_enrichment:
                  type: boolean
                  description: Indique s'il faut enrichir les données de personnes.
                people_enrichment_configs:
                  type: array
                  items:
                    type: object
                  description: >-
                    Tableau de couches d'enrichissement de personnes. Chaque
                    couche exécute une recherche de personnes indépendante.
                    Contient `max_people_to_return` (1-25),
                    `people_contact_types` (tableau — fait référence aux types
                    de contact de
                    [Rachat](/fr/api-reference/endpoint/redeem/people) :
                    email-work, email-personal, phone) et `filters` (mêmes
                    paramètres que le point de terminaison [Recherche de
                    personnes](/fr/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: Type de destination de livraison.
                  enum:
                    - webhook
                    - email
                    - sequences
                destination_config:
                  type: object
                  description: >-
                    Configuration de la destination. Pour un webhook : nécessite
                    `webhook_url` (chaîne), et facultativement `headers` (objet)
                    et `body` (objet). Pour un e-mail : accepte `email` (chaîne)
                    ou `emails` (tableau de chaînes). Pour les séquences :
                    nécessite `sequence_identifier` (chaîne) ainsi qu'au moins
                    l'un des paramètres `is_people_search_enrolled` /
                    `is_company_contact_enrolled` défini sur true.
                  example:
                    webhook_url: https://your-webhook.com/endpoint
                    headers:
                      Authorization: Bearer token
                    body:
                      pipeline: my-webhook
                frequency_minute:
                  type: integer
                  description: >-
                    Fréquence de déclenchement en minutes. Min : 0, Max : 10080,
                    Par défaut : 0.
                  minimum: 0
                  maximum: 10080
                max_failure_trigger:
                  type: integer
                  description: >-
                    Nombre maximal d'échecs consécutifs avant la mise en pause.
                    Min : 1, Max : 10, Par défaut : 5.
                  minimum: 1
                  maximum: 10
                max_daily_trigger:
                  type: integer
                  description: >-
                    Nombre maximal de déclenchements par jour. Min : 0, Max :
                    86400, Par défaut : 500.
                  minimum: 0
                  maximum: 86400
                max_records_per_trigger:
                  type: integer
                  description: >-
                    Contrôle le nombre maximal d'enregistrements livrés par
                    déclenchement. Des valeurs plus faibles réduisent la taille
                    de la charge utile par livraison, ce qui est recommandé pour
                    les jeux de résultats volumineux ou les intégrations à débit
                    limité. Min : 1, Max : 100, Par défaut : 25. Consultez
                    [Configuration des
                    webhooks](/fr/developer-guides/setting-up-webhooks) pour
                    plus d'indications.
                  minimum: 1
                  maximum: 100
                notification_email:
                  type: string
                  format: email
                  description: E-mail pour les notifications d'échec.
                max_retry_per_trigger:
                  type: integer
                  description: >-
                    Nombre maximal de nouvelles tentatives par déclenchement.
                    Min : 0, Max : 3, Par défaut : 1.
                  minimum: 0
                  maximum: 3
                retry_delay_second:
                  type: integer
                  description: >-
                    Délai entre les tentatives, en secondes. Min : 1, Max : 5,
                    Par défaut : 1.
                  minimum: 1
                  maximum: 5
                status:
                  type: string
                  enum:
                    - draft
                    - active
                    - paused
                    - inactive
                  description: >-
                    Statut du cycle de vie à définir. La modification du statut
                    réinitialise le compteur d'échecs.
              required:
                - monitor_id
      responses:
        '200':
          description: >-
            Réponse réussie contenant le moniteur mis à jour. La réponse inclut
            toujours monitor_id, name, detection_mode, destination_type, status,
            masked_signature et last_modified, ainsi que toutes les autres
            colonnes ayant fait partie de la mise à jour.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      monitor_id:
                        type: string
                        format: uuid
                        description: Identifiant unique du moniteur.
                      name:
                        type: string
                        description: Nom du moniteur.
                      detection_mode:
                        type: string
                        description: Mode de détection.
                      destination_type:
                        type: string
                        description: Type de destination de livraison.
                      status:
                        type: string
                        enum:
                          - draft
                          - active
                          - paused
                          - inactive
                        description: Statut du cycle de vie du moniteur.
                      masked_signature:
                        type: string
                        description: Signature webhook masquée.
                      last_modified:
                        type: string
                        format: date-time
                        description: Horodatage de la dernière modification du moniteur.
                    description: >-
                      Le moniteur mis à jour. Toutes les autres colonnes
                      incluses dans la mise à jour sont également renvoyées.
              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: >-
        Requête invalide. La requête était mal formée ou contenait des
        paramètres invalides. Consultez le code d'erreur et le message pour plus
        de détails.
      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: >-
        Limite de débit dépassée. Trop de requêtes ont été effectuées au cours
        d'une période donnée. Réessayez après la réinitialisation de la fenêtre
        de limitation de débit.
      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: >-
        Erreur interne du serveur. Une erreur inattendue s'est produite sur le
        serveur. Contactez le support si l'erreur 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 jeton API unique qui représente les actions que vous effectuez via
        l'API ainsi que les autorisations et opérations correspondantes. Vous
        pouvez le créer dans la section
        [Settings](https://dashboard.pubrio.com/#/settings/).
      in: header

````