Skip to main content
GET
Get trace overview

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Query Parameters

interval
enum<string>
default:hour
Available options:
hour,
six_hours,
day
agent_id
string<uuid> | null
from
string<date-time> | null
to
string<date-time> | null

Response

Successful Response

Aggregates over every telemetry row in the window, so a dashboard never has to page raw rows (and sample them) to draw its tiles.

interval
enum<string>
required
Available options:
hour,
six_hours,
day
buckets
TraceOverviewBucket · object[]
required
agents
TraceOverviewAgent · object[]
required
governance_latency_ms_p50
integer | null
governance_latency_ms_p95
integer | null