Skip to main content
GET
Discover trace search facets

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

project_id
string
required

Project ID.

query
string

Search query.

tool_name
string

Tool name filter.

model
string

Model filter.

agent_name
string

Agent name filter.

has_error
boolean

Span-error axis. true = only traces with span errors, false = only traces without, omitted = unconstrained. Independent of has_issues.

has_issues
boolean

Issue axis. true = only traces with issue occurrences, false = only traces without, omitted = unconstrained. has_error=false with has_issues=true selects silent failures.

status
string

Deprecated alias for the two axes, comma-separated: failures = has_error=true, flagged = has_issues=true, clean = has_error=false and has_issues=false. Cannot express error-only or issue-only; prefer has_error / has_issues, which override it per axis.

error_only
boolean

Restrict the span-level search to error spans. Distinct from has_error, which filters whole traces by error count.

tool_error_only
boolean

Same-span tool-error filter. Requires tool_name. Matches only traces where that tool failed on the same span the Analytics widget counted.

start
string

Start timestamp.

end
string

End timestamp.

min_spans
string

Minimum span count.

max_spans
string

Maximum span count.

min_duration_ms
string

Minimum trace duration (ms).

max_duration_ms
string

Maximum trace duration (ms).

min_tokens
string

Minimum total token count.

min_thread_traces
string

Minimum thread trace count.

max_thread_traces
string

Maximum thread trace count.

attribute_filters
string

JSON-serialized span attribute filters.

sort
string

Trace search sort mode.

max_values
string

Maximum values per facet.

Response

Trace search facets

facets
object[]
required
attribute_fields
object[]
required
meta
object
required