List taxonomy-capable fields

GET/v1/taxonomy/fields

Returns the feedback fields that can be used to generate a taxonomy for a tenant, along with the number of text records and embedded records available per field scope (source_type, source_id, field_id). A field with no attributed source is exposed under the canonical "no source" bucket (empty source_id). Requires Hub embeddings to be configured; otherwise the endpoint returns 503.

Query ParametersExpand Collapse

tenant_id: string

Tenant whose taxonomy-capable fields should be listed.

minLength1

maxLength255

ReturnsExpand Collapse

data: array of object { embedding_count, field_id, record_count, 5 more }

embedding_count: number

Number of those records that have an embedding.

formatint64

field_id: string

record_count: number

Number of text feedback records in the scope.

formatint64

source_id: string

Empty string is the canonical "no source" bucket.

source_type: string

tenant_id: string

field_label: optional string

source_name: optional string

List taxonomy-capable fields

curl http://localhost:8080/v1/taxonomy/fields \
    -H "Authorization: Bearer $HUB_API_KEY"

{
  "data": [
    {
      "embedding_count": 0,
      "field_id": "field_id",
      "record_count": 0,
      "source_id": "source_id",
      "source_type": "source_type",
      "tenant_id": "tenant_id",
      "field_label": "field_label",
      "source_name": "source_name"
    }
  ]
}

Returns Examples

{
  "data": [
    {
      "embedding_count": 0,
      "field_id": "field_id",
      "record_count": 0,
      "source_id": "source_id",
      "source_type": "source_type",
      "tenant_id": "tenant_id",
      "field_label": "field_label",
      "source_name": "source_name"
    }
  ]
}