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
signal_filters
object[]

シグナルフィルターオブジェクトの配列。各オブジェクトは signal_type(jobs、news、advertisements、expansions のいずれか)と filters(シグナル固有のパラメータを含むオブジェクト)で構成されます。シグナルタイプごとの利用可能なフィルターパラメータについては、Job SearchNews SearchAdvertisement Search を参照してください。expansions の場合は、Expansion Search のフィルター語彙(froms / tosstagesmomentumfreshnessscopessignal_typessignal_strengthswindow_days)を使用します。

:
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 を参照)、filtersPeople 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
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 が常に含まれ、加えて更新対象に含まれていたその他のカラムも返されます。

data
object

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