TRtraceroot
Sessions

List Sessions

List unique sessions for the caller's project with trace counts.

Args: auth (DualStampedAuth): Resolved credential context (API key or user session token); scopes the read to its project and stamps the rate-limit identity. limit (int): Items per page (1-200). search_query (str | None): Substring match on session id. start_after (datetime | None): Inclusive lower bound on trace time. end_before (datetime | None): Exclusive upper bound on trace time.

Returns: SessionListResponse: Session summaries, newest first.

Raises: HTTPException: 500 on a reader failure.

get/api/v1/public/sessions

Request

  • Base URL
    https://app.traceroot.ai
  • URL
    https://app.traceroot.ai/api/v1/public/sessions
  • Auth
    HTTP bearer

Query parameters

limitinteger

Items per page

search_querystring nullable

Search by session_id

start_afterstring date-time nullable

Only sessions with traces at or after this time (inclusive, ISO 8601)

end_beforestring date-time nullable

Only sessions with traces before this time (exclusive, ISO 8601)

project_idstring nullable

Target project for the request. Required when authenticating with a user session token (a user credential is only meaningful scoped to a project); for an API key it is optional and, if given, must match the key's project.

Response

Successful Response

Changes

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