Skip to main content
GET
Read a chat session's messages

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

sessionId
string
required

The chat session's id — the same id POST /chat-sessions/messages returns and GET /chat-sessions lists.

Query Parameters

projectId
string

Optional project scope. When set, a session in another project answers 404 — the same answer as absence, so this is never an existence oracle.

afterMessageIndex
integer

Start the window at this absolute transcript index.

Required range: x >= 0
limit
integer
default:50

Messages to return, 1–200. Defaults to 50.

Required range: 1 <= x <= 200

Response

The session and one window of its messages.

sessionId
string
required
projectId
string | null
required
origin
string | null
required
modelId
string | null
required
version
integer | null
required
startedAt
integer | null
required
lastActivityAt
integer | null
required
toolMode
enum<string> | null
required
Available options:
read_only,
auto,
null
environmentId
string | null
required
messageCount
integer | null
required

NULL — never 0 — when the transcript could not be read. Zero would claim the conversation is empty.

messages
object[]
required
transcriptUnavailable
boolean
nextMessageIndex
integer