v52

OpenAPI 3.1.0raw.githubusercontent.com2026-08-03512878906.5 KB
Deprecated

List Sessions

List distinct session IDs from span attributes.

Returns the distinct values of ag.session.id across spans in the current project, in a windowed, cursor-paginated form. Use this to drive a session-picker UI before drilling into the spans of each session.

The realtime flag controls the cursor field:

  • false or unset — paginate by a stable first_active cursor (safe to iterate under heavy write load).
  • true — paginate by last_active, reflecting ongoing activity but less stable between pages.

The response includes a windowing cursor; pass it as windowing.next on the next call to continue.

post/tracing/sessions/query

Request body

realtimeboolean nullable

When true, paginate by last_active (reflects ongoing activity but can shift between pages). When false or unset, paginate by the stable first_active cursor.

Response

Successful Response

countinteger

Number of session IDs in this page.

session_idsstring[]

Distinct values of ag.session.id in this page.