Skip to main content

List sessions

POST 

/api/v1/evals/list-sessions

Lists sessions for the authenticated tenant.

The filters array accepts the session columns id (the session id), userIds, traceTags, createdAt, environment and metadata. Columns aggregated over a session — duration, trace count, tokens, scores, comments — cannot be filtered and are rejected with HTTP 400. There is no free-text search.

Reads are bounded. A session can repeat at an equal-timestamp cursor boundary. Summary activity can extend outside the list window; unavailable rollup data can appear as zero. Do not treat these summaries as a complete frozen cohort.

Request​

Responses​

OK

Document ID: DOC-IS-evaluation-api-listSessions. Section identities and revisions.

SectionStable reference
OverviewDOC-IS-evaluation-api-listSessions#overview
RequestDOC-IS-evaluation-api-listSessions#request
ResponsesDOC-IS-evaluation-api-listSessions#responses