Skip to main content
POST
Suggest data source filter values

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of suggest_data_source_filter_values.

key
string
required

Semantic key: locations | industries | current_companies | past_companies | schools | seniorities | functions | company_sizes | company_types. Wire key: the first five as {id}; seniorities = seniority_levels, company_sizes = company_headcounts, flat ids.

Required string length: 1 - 64
query
string
required

The term as the user said it ("Berlin", "fintech", "Stripe"); the fixed-list facets ignore it and answer their whole list. A busy pool answers 503 or 429 with context.retry_after: wait, then call again.

Required string length: 1 - 100

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required