Sign in
v1
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 chronological order (oldest first)
- `total_count` indicates total messages in the session

**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

Maximum number of messages to return

skipinteger

Number of messages to skip for pagination

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

Example response

{
  "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",
  "total_count": 2
}

Changes