Dex Guide
Dex Dashboard
Companies

Add tags to companies

Tag up to 100 companies (`companyIds`), or one page of a frozen selection, with up to 50 existing workspace tags (`tagIds`), the cartesian product. A selection page is `{ selection_id, offset, limit?

POST /v2/companies/tags/add

Parameters

Header parameters

Idempotency-Key
string required
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

Content-Type: application/json

companyIds
array<string (uuid)>
tagIds
array<string (uuid)> required
selection_id
string
Opaque token from POST /v2/companies/selections.
offset
integer
Position in the selection; next_offset of the previous page.
limit
integer
Page size, at most 100.

Example

{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.affected
integer required
data.ids
array<string>
data.failed
array<object>
data.failed[].id
string
data.failed[].error
object
data.failed[].error.code
string
data.failed[].error.message
string
data.next_offset
integer | null
Offset of the next page; null after the last one.
data.total
integer
Companies in the selection.
data.inserted
integer required
Tag links this call created. Pairs that were already linked count in affected but not here.

Example

{
  "data": {
    "affected": 0,
    "inserted": 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/tags/add \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header "Idempotency-Key: $(uuidgen 2>/dev/null || python3 -c 'import uuid;print(uuid.uuid4())')" \
  --header 'Content-Type: application/json' \
  --data '{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}'

Dismiss a possible duplicate

Mark a pair "not a duplicate" so it stops being suggested, including when enrichment finds it again. The body is `{ company_ids: [idA, idB] }`, in either order; two equal ids are 400 `validation_error

Remove tags from companies

Remove up to 50 tags (`tagIds`) from up to 100 companies (`companyIds`). The tags and companies stay. IDs outside the workspace match nothing. Workspace-only: send the `X-Dex-Workspace` header (404 `r

Copyright © 2026