v28

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

List taxonomy runs

Returns taxonomy run history for a tenant, most recent first. Optionally filter by scope_type, source_type, field_id, and source_id. source_id is a tri-state filter: omit it for no source filter, pass an empty string to scope to the canonical "no source" bucket, or pass a concrete value to match that source.

get/v1/taxonomy/runs

Query parameters

tenant_idstring required
Example:org-123

Tenant whose runs should be listed.

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.

Optional scope type filter. Omitted means no scope type filter.

source_typestring

Optional source_type filter.

source_idstring

Optional source_id filter. Omit for no filter; empty string scopes to the "no source" bucket; a concrete value matches that source.

field_idstring

Optional field_id filter.

limitinteger

Maximum number of runs to return.

Response

Taxonomy run history