ReferenceAgent Session Manager

Get messages for a session

Returns messages for a session.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

sessionIdstringRequired
sessionId

Query parameters

filterslist of anyOptional

Filter criteria — each entry specifies a field, operator, and value

pagedoubleOptional>=1

Page number (1-based)

limitdoubleOptional1-100
Number of items per page
sortByenumOptional
Field to sort by
Allowed values:
sortOrderenumOptional
Sort order
Allowed values:

Response

result
sessionIdstring
Session ID this message belongs to
eventIdstring

Unique identifier for the session message — use with GET /messages/:eventId to fetch full data

timestampdouble
Event timestamp in epoch milliseconds
typeenum

Event type — AEE event type or synthetic merged type (inference-pending, tool-execution)

categoryenum

Display category — AGENT_REASONING (inference), TOOL_CALLED (tools), AGENT_STATUS (lifecycle); never null

dataobject

Event-specific data. ToolExecutionDataDto for tool-execution items; { pauseDurationMs } for agent-session-resumed; { durationMs, tokenUsage } for inference-succeeded; { durationMs } for inference-failed; { errorMessage, errorCategory } for agent-session-failed; empty object () otherwise.

sequenceNumberdouble

Sequence number; null for tool-execution items

textstring

Whatever the model emitted for inference events (text content or error message). Omitted entirely for other event types — clients format display text for those themselves.

Errors

500
Internal Server Error