AGagno
Traces
Traces

Get Trace Statistics by Session

Retrieve aggregated trace statistics grouped by session ID with pagination.

Provides insights into:

  • Total traces per session
  • First and last trace timestamps per session
  • Associated user and agent information

Filtering Options:

  • By user ID
  • By agent ID

Use Cases:

  • Monitor session-level activity
  • Track conversation flows
  • Identify high-activity sessions
  • Analyze user engagement patterns
get/trace_session_stats

Request

Query parameters

user_idstring nullable

Filter by user ID

agent_idstring nullable

Filter by agent ID

team_idstring nullable

Filter by team ID

workflow_idstring nullable

Filter by workflow ID

start_timestring nullable

Filter sessions with traces created after this time (ISO 8601 format with timezone, e.g., '2025-11-19T10:00:00Z' or '2025-11-19T15:30:00+05:30'). Times are converted to UTC for comparison.

end_timestring nullable

Filter sessions with traces created before this time (ISO 8601 format with timezone, e.g., '2025-11-19T11:00:00Z' or '2025-11-19T16:30:00+05:30'). Times are converted to UTC for comparison.

pageinteger

Page number (1-indexed)

limitinteger

Number of sessions per page

db_idstring nullable

Database ID to query statistics from

Response

Trace statistics retrieved successfully

Changes

No recorded changes to this operation across all 1 revision of this API.