Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
tag_names
string[]
required
description
string
required
data_connector_name
string
required
auto_apply
boolean
default:false
existing_categories
Existing Categories · object | null
processing_mode
enum<string> | null

Processing modes the product exposes for standardization.

Exactly the modes the frontend can send:

  • ENTITY_RESOLUTION: embedding-blocked, LLM-adjudicated canonicalization of values that refer to the same entity (see EntityResolver). This is the single "clean up these values" mode. Note: it degrades gracefully to a no-LLM pass (exact-match + high-confidence embedding) when no LLM is configured, so a separate "deduplicate" mode is unnecessary.
  • MAP_TO_CATEGORIES: map values into a provided set of categories.

The no-LLM path still exists internally — the bulk endpoint's only_dedupe flag routes to it (and it is the free/unpermissioned tier in the auth middleware) — but it is not a user-selectable ProcessingMode.

Available options:
entity_resolution,
map_to_categories
custom_context
string | null

Response

Successful Response

tag_results
Tag Results · object
required
job_id
string | null
status
string | null