Skip to main content
POST
モニターの更新

承認

pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
monitor_id
string<uuid>
必須

更新するモニターの一意識別子。

name
string

モニターの名前。

description
string

モニターの説明。

detection_mode
enum<string>

シグナルの検出方法。signal_first は市場全体を広くスキャンし、company_first は指定した企業リストを追跡します(企業・ドメイン・LinkedIn URL のいずれかが 1 件以上必要)。作成後は変更できません — 既存モニターで変更すると 40021 が返ります。新しいモニターを作成してください。

利用可能なオプション:
company_first,
signal_first
signal_types
enum<string>[]

監視対象のシグナルタイプ。

利用可能なオプション:
jobs,
news,
advertisements,
expansions,
cloud_footprints
signal_filters
object[]

モニターが監視するシグナルストリームごとに 1 件。

例:
company_filters
object

グローバル企業フィルター(第2レイヤーとしてすべてのシグナルタイプに適用)。Company Searchエンドポイントと同じパラメータ(locations、employees、technologies、verticals など)を受け付けます。利用可能なフィルターの完全なリストについては Company Search を参照してください。

例:
companies
string<uuid>[]

企業 domain_search_id UUID のリスト。代替: domains または linkedin_urls を使用。

domains
string[]

企業ドメインリスト。companies の代替。

linkedin_urls
string<uri>[]

LinkedInの企業ページURLリスト。companies の代替。

is_company_enrichment
boolean

企業データをエンリッチメントするかどうか。

is_people_enrichment
boolean

人物データをエンリッチメントするかどうか。

people_enrichment_configs
object[]

人物エンリッチメントレイヤーの配列。各レイヤーは独立した人物検索を実行します。max_people_to_return(1-25)、people_contact_types(配列 — Redeem エンドポイントの連絡先タイプ: email-work、email-personal、phone を参照)、filters(People Search エンドポイントと同じパラメータ)を含みます。利用可能なフィルターパラメータについては People Search を、連絡先タイプの詳細については Redeem を参照してください。

例:
destination_type
enum<string>

配信先タイプ。

利用可能なオプション:
webhook,
email,
sequences
destination_config
object

配信先の設定。Webhookの場合:webhook_url(文字列)が必須、headers(オブジェクト)と body(オブジェクト)はオプション。メールの場合:email(文字列)または emails(文字列の配列)を指定できます。sequences タイプは sequence_identifier(文字列)に加えて、is_people_search_enrolled / is_company_contact_enrolled の少なくとも一方を true に設定する必要があります。

例:
frequency_minute
integer

トリガー頻度(分単位)。最小:0、最大:10080、デフォルト:0。

必須範囲: 0 <= x <= 10080
max_failure_trigger
integer

一時停止前の最大連続失敗数。最小:1、最大:10、デフォルト:5。

必須範囲: 1 <= x <= 10
max_daily_trigger
integer

1日あたりの最大トリガー数。最小:0、最大:86400、デフォルト:500。

必須範囲: 0 <= x <= 86400
max_records_per_trigger
integer

トリガーごとに配信される最大レコード数を制御します。値を低く設定すると1回あたりのペイロードサイズが削減され、大量の結果セットやレート制限のある統合に推奨されます。最小値:1、最大値:100、デフォルト:25。詳細については Webhook の設定 をご覧ください。

必須範囲: 1 <= x <= 100
excluded_companies
string[]

このモニターが配信も課金も行わない企業(domain_search_id UUID)。両方の検出モードで実行時に、エンリッチメントと課金の前に適用されます。companies とこのリストの両方にある企業は、リストにある間は除外されます。上限:100,000 件(excluded_companies・excluded_domains・excluded_linkedin_urls の解決後の合計)。

例:
excluded_domains
string[]

除外する企業ドメイン(例:["existing-client.com"])。企業に解決され excluded_companies に統合されます。

例:
excluded_linkedin_urls
string[]

除外する LinkedIn 企業 URL。企業に解決され excluded_companies に統合されます。

例:
companies_mode
enum<string>

送信した companies / domains / linkedin_urls を保存済みのウォッチリストにどう適用するか:replace(デフォルト)はリスト全体を置き換え、add は送信した企業を追加、remove は削除します。送らなかったリストは変更されません。

利用可能なオプション:
replace,
add,
remove
例:

"add"

excluded_companies_mode
enum<string>

除外リスト(excluded_companies / excluded_domains / excluded_linkedin_urls)も同様:replace(デフォルト)、add、remove。

利用可能なオプション:
replace,
add,
remove
例:

"add"

record_unit
enum<string>

配信レコード 1 件の単位:signal(ペイロードは signals[]、シグナルごとに 1 件)または company(ペイロードは companies[]、企業ごとに 1 件でシグナルをネスト)。デフォルトは detection_mode に従います:signal_first → signal、company_first → company。各上限(max_records_per_trigger、max_daily_records)はこの単位で数えます。

利用可能なオプション:
signal,
company
例:

"company"

company_dedupe_days
integer

同じ企業はこの日数内に最大 1 回の配信にしか現れません(モニターの全シグナルタイプ横断)。ウィンドウ内に配信済みの企業は以降の配信から外れ、ウィンドウ内のその後のシグナルは待機せずスキップされます。0 = オフ。デフォルト:0。

必須範囲: x >= 0
例:

30

is_newest_first
boolean

一致したシグナルのうち最新のものから配信します。トリガー毎または日次の上限では最新のレコードが残り、モニターのカーソルは取得した最新行まで進むため、古い行はキューされずスキップされます。デフォルト false(古い順、スキップなし)。

例:

true

max_daily_records
integer

所有者のタイムゾーンの暦日あたりに配信するレコード数の上限(0 = 無制限)。成功した配信をモニターのレコード単位で数え、1 回のトリガーは残り分までしか配信せず、その後はカーソルを進めずに翌日まで待ちます。デフォルト:0。

必須範囲: x >= 0
例:

200

notification_email
string<email>

失敗通知用のメールアドレス。

max_retry_per_trigger
integer

トリガーあたりの最大リトライ回数。最小:0、最大:3、デフォルト:1。

必須範囲: 0 <= x <= 3
retry_delay_second
integer

リトライ間の遅延(秒単位)。最小:1、最大:5、デフォルト:1。

必須範囲: 1 <= x <= 5
status
enum<string>

設定するライフサイクルステータス。ステータスを変更すると失敗カウンターがリセットされます。

利用可能なオプション:
draft,
active,
paused,
inactive

レスポンス

更新されたモニターを含む成功レスポンスです。レスポンスには monitor_id、name、detection_mode、destination_type、status、masked_signature、last_modified が常に含まれ、加えて更新対象に含まれていたその他のカラムも返されます。

metadata
object
data
object

更新されたモニター。更新に含まれていたその他のカラムも返されます。

最終更新日 2026年8月28日