Skip to main content

Get messages for a session

GET 
/api/projects/:projectId/sessions/:id/messages

Read the transcript of a session. Without query parameters the full transcript is returned as a plain array (legacy, deprecated for polling). With after, limit, order or include the response is a page (MessageListResponse) with keyset pagination on the per-session seq: poll with after=<latestSeq> and If-None-Match: "<latestSeq>" to receive 304 Not Modified while nothing changed. include=annotations,debugAudio adds plugin annotations and the hasDebugAudio flag; both cost an extra query and are omitted otherwise.

Request​

Responses​

The transcript: a plain Message[] for the legacy call without parameters, a MessageListResponse page otherwise

Response Headers
    ETag

    Newest seq of the session, quoted (omitted when annotations are included)