latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-15142192531.5 KB

7d1aff84ce3b

User testing

Get a session transcript

The projected transcript, paged. Tool payloads and blobs are dropped, and the stored blob URL is never returned.

Check transcriptUnavailable before trusting messageCount: an unreadable transcript reports null, never 0.

get/projects/{projectId}/user-testing/scenarios/{scenarioId}/sessions/{sessionId}

Request body

cursorstring

Opaque pagination cursor from a previous response's nextCursor. Don't parse it.

Response

The session and its messages.

idstring required
scenarioIdstring required
chatSessionIdstring nullable required
modelIdstring nullable required
startedAtnumber nullable required

Epoch milliseconds.

lastActivityAtnumber nullable required

Epoch milliseconds.

messageCountinteger nullable required

null — never 0 — when the transcript could not be read. Zero would be a claim the visitor said nothing, the opposite of what an unreadable blob means, and a caller checking only this field would act on it.

transcriptUnavailableboolean

True when the stored conversation could not be read. Distinct from an empty messages, which means the visitor genuinely said nothing.

nextCursorstring