ITitential
Agent Session Manager

Get messages for a session

Changed on

Returns messages for a session.

get/agent-session-manager/sessions/{sessionId}/messages

Request

  • Base URL
    https://example.itential.io
  • URL
    https://example.itential.io/agent-session-manager/sessions/{sessionId}/messages
  • Auth
    none declared

Path parameters

sessionIdstring required

sessionId

Query parameters

unknown

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

pagenumber double

Page number (1-based)

limitnumber double

Number of items per page

sortBy'eventId' | 'timestamp'

Field to sort by

sortOrder'asc' | 'desc'

Sort order

Response

result

sessionIdstring required

Session ID this message belongs to

eventIdstring required

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

timestampnumber double required

Event timestamp in epoch milliseconds

type'inference-pending' | 'inference-succeeded' | 'inference-failed' | 'tool-execution' | 'agent-session-paused' | 'agent-session-resumed' | 'agent-session-completed' | 'agent-session-failed' | 'agent-session-canceled' required

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

category'AGENT_REASONING' | 'TOOL_CALLED' | 'AGENT_STATUS' required

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

sequenceNumbernumber double

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.

dataAgentSessionManagerSessionsSessionIdMessagesGetResponsesContentApplicationJsonSchemaItemsData required

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.

Changes