For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Comma-separated span fields to group by, e.g. trace_id or session_id,trace_id.
pageintegerOptional>=1Defaults to 1
Page number.
page_sizeintegerOptional1-1000Defaults to 10
Page size.
sortenumOptionalDefaults to -span_count
Sort groups by size or by start time. Use -started_at for the traces or sessions that began most recently, which answers ‘what ran lately’ in one call instead of paging through spans. A group’s time is its earliest matching span, so this orders by when work started and not by when it was last active.
Allowed values:
filterobjectOptional
Filter spans by the same fields as the span list endpoint, then group matching spans by the comma-separated fields in the by query parameter.