Dex Guide
Dex Dashboard
Companies

Freeze a company selection

Resolve `where` (the `POST /v2/companies/filter` filter) and optional `view_id`, less `excluded_ids` (up to 10,000), once, and store the ids for 1 hour under a token bound to the caller, the workspace

POST /v2/companies/selections

Request body

Content-Type: application/json

action
string enum required
Possible values: "archive", "restore", "delete", "tag", "view", "custom_field", "export"
where
object required
where.name
object
where.name.operator
string enum
Possible values: "contains", "not_contains", "eq"
where.name.value
string
where.search
string
where.description
object
where.description.operator
string enum
Possible values: "contains", "not_contains"
where.description.value
string
where.headquarters_location
object
where.headquarters_location.operator
string enum
Possible values: "contains", "not_contains", "eq"
where.headquarters_location.value
string
where.employees
object
where.employees.in
array<string enum>
where.connections
object
where.connections.operator
string enum
Possible values: "eq", "gte", "lte"
where.connections.value
integer
where.country_code
object
where.country_code.operator
string enum
Possible values: "in", "not_in"
where.country_code.values
array<string>
where.linkedin_industry
object
where.linkedin_industry.operator
string enum
Possible values: "in", "not_in"
where.linkedin_industry.values
array<string>
where.linkedin_company_type
object
where.linkedin_company_type.operator
string enum
Possible values: "in", "not_in"
where.linkedin_company_type.values
array<string enum>
where.assignee
object
where.assignee.operator
string enum
Possible values: "in", "not_in"
where.assignee.values
array<string enum>
where.tags
object
where.tags.operator
string enum
Possible values: "any", "all", "none"
where.tags.tag_ids
array<string (uuid)>
where.starred
boolean
where.archived
boolean
where.custom_fields
array<object>
where.custom_fields[].field_id
string (uuid)
where.custom_fields[].operator
string enum
Possible values: "contains", "eq", "in", "not_in", "present", "absent", "gte", "lte"
where.custom_fields[].value
string
view_id
string (uuid)
excluded_ids
array<string (uuid)>

Example

{
  "action": "archive",
  "where": {
    "name": {
      "operator": "contains",
      "value": "string"
    },
    "search": "string"
  }
}

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.selection_id
string required
Opaque token from POST /v2/companies/selections.
data.count
integer required

Example

{
  "data": {
    "selection_id": "string",
    "count": 0
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)
any

401 — Missing or invalid API key.

Content-Type: application/json

(body)
any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)
any

404 — Resource does not exist.

Content-Type: application/json

(body)
any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)
any

429 — Rate limit exceeded.

Content-Type: application/json

(body)
any

500 — Unexpected server error.

Content-Type: application/json

(body)
any

Code samples

curl https://api.prod.getdex.com/v2/companies/selections \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "archive",
  "where": {
    "name": {
      "operator": "contains",
      "value": "string"
    },
    "search": "string"
  }
}'

Filter companies

Filter and sort the workspace's companies, one keyset page at a time, each with its stats. `where` ANDs its clauses: `name`, `description` and `headquarters_location` (`contains`, `not_contains`, or `

Export companies as CSV

Download the workspace's companies as one CSV file, ordered by name, then id. The body takes exactly one of three shapes: `{ company_ids }` (1-50,000 ids; archived companies included, ids outside the

Copyright © 2026