Skip to main content
PUT
Replace the signal search behind a table

Authorizations

X-API-Key
string
header
required

Path Parameters

table_id
string<uuid>
required

Body

application/json

Replace the signal search behind a table.

signal_type
enum<string>
required

Which buying signal a search is looking for.

Each member names one discovery question the provider can answer, and each maps to exactly one upstream endpoint. The last two are firmographic rather than event-shaped — they find companies by what they ARE rather than by what they DID — and are kept in the same enum because they land the same company rows through the same machinery.

Available options:
hiring,
news,
technology,
portfolio_companies,
financing,
products,
firmographics,
extended_firmographics
query
SignalQuerySchema · object

Every filter any signal type can take.

ONE schema for all eight types, mirroring the domain's single query dataclass. Which of these a given signal type actually accepts is decided by the domain's per-type allow-list, and a filter the type cannot use is REJECTED with a 422 naming it — never quietly dropped.

An empty query is valid here. Discovery is bounded by the row cap rather than by the filters, so "the companies that most recently raised" is a legitimate search.

row_limit
integer | null
Required range: x >= 1

Response

Successful Response

The persisted signal search a table was built from.

query
Query · object
required

The filters, in this API's own request shape, ready to rehydrate a builder.

row_limit
integer | null
required
signal_type
enum<string>
required

Which buying signal a search is looking for.

Each member names one discovery question the provider can answer, and each maps to exactly one upstream endpoint. The last two are firmographic rather than event-shaped — they find companies by what they ARE rather than by what they DID — and are kept in the same enum because they land the same company rows through the same machinery.

Available options:
hiring,
news,
technology,
portfolio_companies,
financing,
products,
firmographics,
extended_firmographics
table_id
string<uuid>
required