Skip to main content
PUT
Create or update an ICP signal watch

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Path Parameters

icpCriteriaID
string
required

ICP criteria UUID. Create one via Create an ICP criteria.

Query Parameters

account_id
string

Target account UUID. Required for staff; ignored for customer keys.

Body

application/json
signal_types
string[] | null
required

Signal types to detect. Supported: news, job_posting.

Example:
is_enabled
boolean

Defaults to true. Set false to record events without delivering them.

Example:

true

news_topics
string[] | null

Which news topics to search. Supported: m_and_a, rebranding, funding_round, product_launch, relocation. Omit or send an empty array for every topic. Narrowing costs nothing and searches each selected topic more deeply, since a run's article budget is split across (markets x topics). Ignored when signal_types does not include news.

Example:

Response

OK

created_at
string<date-time>
required

When the watch was first created.

icp_criteria_id
string
required

The ICP whose matching companies are watched.

id
string
required

Watch UUID. Stable across reconfigurations; every endpoint keys on icp_criteria_id instead, so you rarely need this.

is_enabled
boolean
required

When false the watch keeps detecting and recording events but delivers nothing — useful to inspect what an ICP would produce before acting on it.

news_topics
string[] | null
required

News topics this watch searches. Empty means every supported topic.

Example:
signal_types
string[] | null
required

Signal types this watch produces.

Example:
updated_at
string<date-time>
required

When the watch was last reconfigured.