Skip to main content
GET
Search trace evidence

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.

trace_id
string

Restrict evidence search to one trace.

sort
string

Trace search sort mode.

cursor
string

Opaque cursor for the next ranked result page.

limit
integer

Maximum number of records to return.

Required range: x >= 1

Response

Evidence search results

results
object[]
required
meta
object
required