v28

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-07-082940159.9 KB

Taxonomy

Get the active taxonomy tree for a scope

Returns the currently active taxonomy run and its tree for a field or directory scope. Exactly one run is active per scope at a time. Returns 404 when no run has been activated for the scope.

get/v1/taxonomy/runs/active/tree

Query parameters

tenant_idstring required

Example:org-123

Tenant that owns the scope.

scope_type'field' | 'directory'

Taxonomy input scope. field covers one (source_type, source_id, field_id) field scope. directory covers all text feedback records for the tenant/directory and must not include source_type, source_id, or field_id.

Scope type. Omit for field scope; use directory with tenant_id only for directory taxonomy.

source_typestring

Source type of a field scope. Must be omitted for directory scope.

source_idstring

Source ID of the scope; empty string is the canonical "no source" bucket.

field_idstring

Field ID of a field scope. Must be omitted for directory scope.

Response

The active run and its taxonomy tree