Skip to main content
GET
List dashboard traces

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.

limit
integer

Maximum number of records to return.

Required range: x >= 1
cursor
string

Pagination cursor.

agent_name
string

Agent name filter.

sort
string

Sort order.

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.

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 (input + output) tokens.

min_thread_traces
string

Minimum number of traces in the session/thread.

max_thread_traces
string

Maximum number of traces in the session/thread.

Response

Dashboard traces

data
object[]
required
total
number
required
next_cursor
object | null
required