upstack filters

List the filter-fields catalog from the command line. Find canonical filter field ids, value types, operators, and applicable contexts before constructing a —filter.

List the catalog of filter fields available across every query endpoint. Each entry declares its operators, value type, and the contexts it applies in. Useful for finding canonical filter field ids before constructing a query, attribution query, cohort analysis, or channel-details listing. Wraps GET /api/filters — see the API reference.

Usage

upstack filters

The endpoint takes no parameters — the full catalog is returned in one call. Results are cached locally for 1 hour; pass --no-cache to refetch.

Flags

Flag	Description
--search <term>	Filter results by keyword (matches field and label).
--detail	Include label, description, value type, supported operators, and applicable contexts.
--operators	Show supported operators inline next to each field.
--json	Print the raw response as JSON (one object per field).
--no-cache	Bypass the local 1-hour cache and refetch.

Examples

upstack filters
upstack filters --search utm
upstack filters --detail
upstack filters --operators
upstack filters --json | jq '.[] | select(.applicableContexts | index("attribution"))'

Narrowing by endpoint context

Every entry carries an applicableContexts array listing which endpoints it applies to (query_measures, cohort_analysis, products_report, attribution, channel_details, emq_analytics). Use --detail to see them inline, or --json to narrow with jq:

# Fields valid on POST /api/query-channel-details
upstack filters --json | jq '.[] | select(.applicableContexts | index("channel_details"))'