Messages

Get Session History

Retrieve message history for a specific conversation session.

**Authentication Required**: Bearer token, API key, or session token

**Pagination**:
- Use `limit` and `skip` parameters for pagination
- Messages are returned in **reverse chronological order** (newest first)
- `total_count` indicates total messages in the session

**Summaries** (if available):
- Returns hierarchical conversation summaries (short/medium/long-term)
- Includes `context_for_llm` field with pre-compressed context
- Summaries are automatically generated every 15 messages
- Use `/sessions/{session_id}/compress` endpoint to retrieve on-demand

**Access Control**:
- Only returns messages for the authenticated user
- Workspace scoping is applied if available

get/v1/messages/sessions/{session_id}

Path parameters

session_idstring required

Query parameters

limitinteger

Maximum number of messages to return

skipinteger

Number of messages to skip for pagination

Response

Message history retrieved

sessionIdstring required

Session ID of the conversation

total_countinteger required

Total number of messages in the session

context_for_llmstring nullable

Pre-formatted compressed context ready for LLM consumption (summaries + recent messages)

Example response

{
  "context_for_llm": "FULL SESSION: Product planning and strategy conversation\nRECENT (last ~100): Ongoing product planning discussion for Q4\nCURRENT (last 15): User requested help planning Q4 product roadmap",
  "messages": [
    {
      "content": "Can you help me plan the Q4 product roadmap?",
      "createdAt": "2024-01-15T10:30:00Z",
      "objectId": "msg_abc123",
      "processing_status": "completed",
      "role": "user",
      "sessionId": "session_123"
    },
    {
      "content": "I'd be happy to help you plan your Q4 roadmap. Let's start by identifying your key objectives.",
      "createdAt": "2024-01-15T10:31:00Z",
      "objectId": "msg_def456",
      "processing_status": "completed",
      "role": "assistant",
      "sessionId": "session_123"
    }
  ],
  "sessionId": "session_123",
  "summaries": {
    "long_term": "Product planning and strategy conversation",
    "medium_term": "Ongoing product planning discussion for Q4",
    "short_term": "User requested help planning Q4 product roadmap",
    "topics": [
      "product",
      "roadmap",
      "planning",
      "Q4"
    ]
  },
  "total_count": 2
}

Changes

Changed in 9 of the 37 revisions of this API.1726

Jun 11, 2026f29d29d1ad169See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added subschema #2 to the // response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the // response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 11, 202622d84aa060d67See the full diff
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 10, 2026871a12102bbe2See the full diff
- ○
  added to the // response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed subschema #2 from the // response property anyOf list for the response status
  response-property-any-of-removed
Jun 10, 2026b8ef009d36069See the full diff
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
Mar 13, 20260e4854909d2a2See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Feb 7, 20265f5df128dbcd2See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Nov 18, 2025fbb4c9d1fbda1See the full diff
- ○
  endpoint added
  endpoint-added
Nov 7, 2025cce4143121781See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
Nov 7, 202514ff137558711See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history