메인 콘텐츠로 건너뛰기
POST
/
monitors
/
update
모니터 수정
curl --request POST \
  --url https://api.pubrio.com/monitors/update \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "detection_mode": "company_first",
  "signal_types": [
    "jobs"
  ],
  "signal_filters": [
    {
      "filters": {
        "locations": [
          "US"
        ]
      },
      "signal_type": "jobs"
    },
    {
      "filters": {
        "locations": [
          "US"
        ]
      },
      "signal_type": "news"
    },
    {
      "filters": {
        "target_locations": [
          "US"
        ]
      },
      "signal_type": "advertisements"
    }
  ],
  "company_filters": {
    "locations": [
      "US"
    ],
    "employees": [
      [
        501,
        1000
      ],
      [
        1001,
        5000
      ]
    ]
  },
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "<string>"
  ],
  "linkedin_urls": [
    "<string>"
  ],
  "is_company_enrichment": true,
  "is_people_enrichment": true,
  "people_enrichment_configs": [
    {
      "filters": {
        "people_locations": [
          "US"
        ]
      },
      "max_people_to_return": 3,
      "people_contact_types": [
        "email-work"
      ]
    }
  ],
  "destination_type": "webhook",
  "destination_config": {
    "webhook_url": "https://your-webhook.com/endpoint",
    "headers": {
      "Authorization": "Bearer token"
    },
    "body": {
      "pipeline": "my-webhook"
    }
  },
  "frequency_minute": 5040,
  "max_failure_trigger": 5,
  "max_daily_trigger": 43200,
  "max_records_per_trigger": 50,
  "notification_email": "[email protected]",
  "max_retry_per_trigger": 1,
  "retry_delay_second": 3,
  "is_active": true,
  "is_paused": true,
  "profile_id": 123
}
'
{
  "data": {
    "monitor_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Updated Monitor Name",
    "description": "Updated description",
    "detection_mode": "company_first",
    "signal_types": [
      "jobs",
      "news"
    ],
    "destination_type": "webhook",
    "is_active": true,
    "is_paused": false,
    "created_at": "2026-03-15T10:00:00.000Z",
    "last_modified": "2026-04-05T21:00:00.000Z",
    "statistics": {
      "total_triggers": 120,
      "total_success": 118,
      "success_rate": 0.983
    }
  }
}

인증

​
pubrio-api-key
string
header
필수

API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 설정 섹션에서 생성할 수 있습니다.

본문

application/json
​
monitor_id
string<uuid>
필수

업데이트할 모니터의 고유 식별자입니다.

​
name
string

모니터의 이름입니다.

​
description
string

모니터의 설명입니다.

​
detection_mode
enum<string>

감지 모드입니다.

사용 가능한 옵션:
company_first,
signal_first
​
signal_types
enum<string>[]

모니터링할 신호 유형입니다.

사용 가능한 옵션:
jobs,
news,
advertisements
​
signal_filters
object[]

신호 필터 객체 배열입니다. 각 객체는 signal_type (jobs, news, advertisements 중 하나)과 filters (신호별 매개변수가 포함된 객체)로 구성됩니다. 사용 가능한 필터 매개변수는 Job Search, News Search 또는 Advertisement Search 엔드포인트를 참조하세요.

예시:
[
  {
    "filters": { "locations": ["US"] },
    "signal_type": "jobs"
  },
  {
    "filters": { "locations": ["US"] },
    "signal_type": "news"
  },
  {
    "filters": { "target_locations": ["US"] },
    "signal_type": "advertisements"
  }
]
​
company_filters
object

글로벌 기업 필터로 두 번째 레이어로 적용됩니다. Company Search 엔드포인트와 동일한 매개변수 — locations, employees, technologies, verticals 등을 허용합니다.

예시:
{
  "locations": ["US"],
  "employees": [[501, 1000], [1001, 5000]]
}
​
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을 참조하세요.

예시:
[
  {
    "filters": { "people_locations": ["US"] },
    "max_people_to_return": 3,
    "people_contact_types": ["email-work"]
  }
]
​
destination_type
enum<string>

전달 대상 유형입니다.

사용 가능한 옵션:
webhook,
email,
sequences
​
destination_config
object

대상 구성입니다. 웹훅의 경우: webhook_url (문자열) 필수, headers (객체) 및 body (객체) 선택 사항. 이메일의 경우: email (문자열) 필수. sequences 유형은 sequence_identifier(문자열)와 record_type(문자열)이 필요합니다.

예시:
{
  "webhook_url": "https://your-webhook.com/endpoint",
  "headers": { "Authorization": "Bearer token" },
  "body": { "pipeline": "my-webhook" }
}
​
frequency_minute
integer

트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.

필수 범위: 0 <= x <= 10080
​
max_failure_trigger
integer

일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.

필수 범위: 1 <= x <= 10
​
max_daily_trigger
integer

일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.

필수 범위: 0 <= x <= 86400
​
max_records_per_trigger
integer

트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 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
​
is_active
boolean

모니터 활성화 여부입니다.

​
is_paused
boolean

모니터 일시 중지 여부입니다.

​
profile_id
integer

선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.

응답

업데이트된 전체 모니터 객체가 포함된 성공적인 응답입니다.

​
data
object