Skip to main content
GET
Each record type has one tag field: Account tags, Connector tags and Intro tags. The API calls them tag groups, hence the path. Every label on a record is a tag in one of these fields, so this is the lookup that makes every other tag call usable: assignments and filters take each tag’s Clustr ID, clustr_tag_id, and those come from here. See Tags for the model.

The three fields

selection is always multi: a record can carry any number of its field’s tags.
Tracking where an intro stands. Intro tags (path) do it. A tag with closes: true closes the intro it is on.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Headers

X-Clustr-Fresh
enum<string>

Send 1 for about 10 seconds after a write of your own: the read waits up to queries.clickhouse.write_wait_ms (default 6 s) for that write and is never answered from a last-good copy. Do not send it on every request.

Available options:
1

Query Parameters

subject_type
enum<string>

Only the fields for this kind of record. Omit for all three.

Available options:
account,
person,
path
with_counts
string

true adds the per-tag record counts.

Response

Typed result envelope.

success
boolean
required
data
object
required