LAlatitude-dev
Sessions

List project sessions

Changed on

Returns a cursor-paginated page of sessions in the project. A session groups the traces of one conversation. Combine filters with query (free-text semantic search) to narrow the result set. Session list rows exclude per-message LLM content — use getSession for the conversation view.

post/v1/projects/{projectSlug}/sessions/list

Request

  • Base URL
    https://api.latitude.so
  • Auth
    HTTP bearer

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier). The CLI can also read this from the LATITUDE_PROJECT_SLUG environment variable.

Request body

cursorstring

Opaque cursor returned in a previous response's nextCursor. Omit on the first page.

limitinteger

Page size. Defaults to 50; max 200.

sortBy'lastActivity' | 'startTime' | 'duration' | 'ttft' | 'cost' | 'spans' | 'traceCount'

Field to sort by. Defaults to lastActivity (most recently active first).

sortDirection'asc' | 'desc'

Sort direction. Defaults to desc (most recent first).

querystring

Free-text semantic search across the sessions' traces (input and output messages). Combined with filters via AND.

filtersSessionFilterSet

Filter set keyed by session field. Each entry holds an array of conditions ANDed together for that field; field-level groups are ANDed across the set. Valid fields: status, name, traceId, sessionId, simulationId, userId, tags, moments, topics, models, providers, serviceNames, tools, definedTools, duration, ttft, cost, spanCount, errorCount, tokensInput, tokensOutput, cacheHitRate, startTime, endTime; score-derived keys (score.passed, score.errored, score.value, score.source, score.sourceId, score.annotatorId, score.signalId, score.simulationId); and arbitrary metadata via metadata.<key>. moments filters by conversation moment kind and topics by behavior topic id (a topic matches its whole subtree). startTime/endTime take ISO-8601 values (a session's first span start / last span end). gtePercentile is only supported on duration/ttft/cost. Unknown fields are rejected rather than ignored.

Response

Page of sessions

nextCursorstring nullable required

Opaque cursor for fetching the next page. null when there are no more pages. Pass it back in cursor to continue.

hasMoreboolean required

true when there is at least one more page after this one.

Changes