Skip to main content
POST
Read message history of a session (normalized)

Body

application/json
count
string

Number of messages to show (default: 20)

messageId
string

Return metadata for a single message (transcription, mediaType) using session history as fallback

nameOrKey
string

Optional session name/key override (defaults to current session)

visibility
boolean

Include the skill catalog from runtimeSessionParams.skillVisibility

workspace
boolean

Return workspace projection: merged provider+chat history with flat timeline (history-only)

Response

Success — body conforms to the @Returns schema.

messages
object[]
required
session
object
required
transcript
object
required
count
integer
Required range: 0 <= x <= 9007199254740991
totalMessages
integer
Required range: 0 <= x <= 9007199254740991
{key}
any