Skip to main content
POST
Mettre à jour un moniteur

Autorisations

pubrio-api-key
string
header
requis

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.

Corps

application/json
monitor_id
string<uuid>
requis

Identifiant unique du moniteur à mettre à jour.

name
string

Nom du moniteur.

description
string

Description du moniteur.

detection_mode
enum<string>

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.

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

Types de signaux à surveiller.

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

Une entrée par flux de signal surveillé par le moniteur.

Exemple:
company_filters
object

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 — localisations, effectifs, technologies, secteurs verticaux, etc.

Exemple:
companies
string<uuid>[]

Liste d'UUID domain_search_id d'entreprise. Alternative : utilisez domains ou linkedin_urls.

domains
string[]

Liste de domaines d'entreprise. Alternative à companies.

linkedin_urls
string<uri>[]

Liste d'URL LinkedIn d'entreprise. Alternative à companies.

is_company_enrichment
boolean

Indique s'il faut enrichir les données d'entreprise.

is_people_enrichment
boolean

Indique s'il faut enrichir les données de personnes.

people_enrichment_configs
object[]

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 : email-work, email-personal, phone) et filters (mêmes paramètres que le point de terminaison Recherche de personnes).

Exemple:
destination_type
enum<string>

Type de destination de livraison.

Options disponibles:
webhook,
email,
sequences
destination_config
object

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.

Exemple:
frequency_minute
integer

Fréquence de déclenchement en minutes. Min : 0, Max : 10080, Par défaut : 0.

Plage requise: 0 <= x <= 10080
max_failure_trigger
integer

Nombre maximal d'échecs consécutifs avant la mise en pause. Min : 1, Max : 10, Par défaut : 5.

Plage requise: 1 <= x <= 10
max_daily_trigger
integer

Nombre maximal de déclenchements par jour. Min : 0, Max : 86400, Par défaut : 500.

Plage requise: 0 <= x <= 86400
max_records_per_trigger
integer

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 pour plus d'indications.

Plage requise: 1 <= x <= 100
excluded_companies
string[]

Entreprises que ce moniteur ne livre ni ne facture jamais, sous forme d'UUID domain_search_id. Appliqué dans les deux modes de détection à l'exécution, avant l'enrichissement et la facturation ; une entreprise présente à la fois dans companies et dans cette liste est exclue tant qu'elle reste sur la liste. Taille maximale : 100 000 (ids résolus entre excluded_companies, excluded_domains et excluded_linkedin_urls).

Exemple:
excluded_domains
string[]

Domaines d'entreprise à exclure (ex. ["existing-client.com"]). Résolus en entreprises et fusionnés dans excluded_companies.

Exemple:
excluded_linkedin_urls
string[]

URL d'entreprise LinkedIn à exclure. Résolues en entreprises et fusionnées dans excluded_companies.

Exemple:
companies_mode
enum<string>

Comment les companies / domains / linkedin_urls envoyés s'appliquent à la liste de suivi enregistrée : replace (par défaut) remplace toute la liste, add ajoute les entreprises envoyées, remove les retire. Les listes omises ne sont jamais touchées.

Options disponibles:
replace,
add,
remove
Exemple:

"add"

excluded_companies_mode
enum<string>

Idem pour la liste d'exclusion (excluded_companies / excluded_domains / excluded_linkedin_urls) : replace (par défaut), add ou remove.

Options disponibles:
replace,
add,
remove
Exemple:

"add"

record_unit
enum<string>

Ce qu'est un enregistrement livré : signal (payload signals[], une entrée par signal) ou company (payload companies[], une entrée par entreprise avec ses signaux imbriqués). Par défaut suit detection_mode : signal_first → signal, company_first → company. Les plafonds (max_records_per_trigger, max_daily_records) comptent cette unité.

Options disponibles:
signal,
company
Exemple:

"company"

company_dedupe_days
integer

Une entreprise apparaît dans au plus une livraison par ce nombre de jours, tous types de signaux du moniteur confondus ; une entreprise livrée dans la fenêtre est écartée des livraisons suivantes et ses signaux suivants dans la fenêtre sont ignorés, pas mis en attente. 0 = désactivé. Par défaut : 0.

Plage requise: x >= 0
Exemple:

30

is_newest_first
boolean

Livrer d'abord les signaux correspondants les plus récents. Avec un plafond par déclenchement ou quotidien, les enregistrements les plus récents sont gardés et le curseur du moniteur avance quand même jusqu'à la ligne la plus récente récupérée ; les lignes plus anciennes sont ignorées, jamais mises en attente. Par défaut false (les plus anciennes d'abord, rien d'ignoré).

Exemple:

true

max_daily_records
integer

Plafond strict d'enregistrements livrés par jour civil dans le fuseau du propriétaire (0 = illimité). Compté dans l'unité d'enregistrement du moniteur sur les livraisons réussies ; un déclenchement livre au plus le budget restant, puis le moniteur attend le lendemain sans déplacer son curseur. Par défaut : 0.

Plage requise: x >= 0
Exemple:

200

notification_email
string<email>

E-mail pour les notifications d'échec.

max_retry_per_trigger
integer

Nombre maximal de nouvelles tentatives par déclenchement. Min : 0, Max : 3, Par défaut : 1.

Plage requise: 0 <= x <= 3
retry_delay_second
integer

Délai entre les tentatives, en secondes. Min : 1, Max : 5, Par défaut : 1.

Plage requise: 1 <= x <= 5
status
enum<string>

Statut du cycle de vie à définir. La modification du statut réinitialise le compteur d'échecs.

Options disponibles:
draft,
active,
paused,
inactive

Réponse

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.

metadata
object
data
object

Le moniteur mis à jour. Toutes les autres colonnes incluses dans la mise à jour sont également renvoyées.

Dernière modification le 4 septembre 2026