Hanzo
OpenapiO11y

Lists the traces that match a funnel described inline — the builder's "try…

Lists the traces that match a funnel described inline — the builder's "try this" before anything is saved.

POST /v1/o11y/trace-funnels/analytics/validate

Addresshttps://api.hanzo.ai/v1/o11y/trace-funnels/analytics/validate
MethodPOST
OperationValidateDraftFunnelTraces
AuthAuthorization: Bearer $HANZO_API_KEY

Lists the traces that match a funnel described inline — the builder's "try this" before anything is saved.

Request

25 fields, body application/json (required).

FieldInTypeRequiredDescription
end_timebodyintegerEndTime is the end of the window, as a millisecond epoch.
start_timebodyintegerStartTime is the start of the window, as a millisecond epoch.
step_endbodyintegerStepEnd is the step the transition runs to, 1-based.
step_startbodyintegerStepStart is the step the transition runs from, 1-based.
stepsbodyo11y.FunnelStep[]Steps are the funnel's steps, in order.
steps[].descriptionbodystringstep description
steps[].filtersbodyo11y.FilterSet
steps[].filters.itemsbodyo11y.FilterItem[]
steps[].filters.items[].keybodyo11y.AttributeKey
steps[].filters.items[].key.dataTypebodystring
steps[].filters.items[].key.isColumnbodyboolean
steps[].filters.items[].key.isJSONbodyboolean
steps[].filters.items[].key.keybodystring
steps[].filters.items[].key.typebodystring
steps[].filters.items[].opbodystring
steps[].filters.items[].valuebodyobject
steps[].filters.opbodystring
steps[].has_errorsbodyboolean
steps[].idbodyany
steps[].latency_pointerbodystring
steps[].latency_typebodystring
steps[].namebodystringstep name
steps[].service_namebodystring
steps[].span_namebodystring
steps[].step_orderbodyinteger

Response

StatusBodyMeaning
200o11y.O11yFunnelRowsOutok

200 body — 5 fields.

FieldInTypeAlwaysDescription
databodyo11y.O11yFunnelRow[]Data are the rows.
data[].databodyobjectData are the row's columns, keyed by column name.
data[].data.*bodyobject
data[].timestampbodystringTimestamp is the row's time.
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y trace-funnels analytics validate-all

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page