# Sessions

Endpoints for managing agent sessions

## Get the session data

 - [GET /core/v1/sessions/{session_id}](https://api.docs.wabee.ai/openapi/sessions/get_session_core_v1_sessions__session_id__get.md): Retrieves the complete conversation history and metadata for a specific session.
    
    The session data includes:
    - All messages exchanged between user and AI
    - Timestamps for each message
    - Additional context like reasoning steps for AI responses
    - Session metadata
    
    Each message contains:
    - role: Either 'human' or 'ai'
    - content: The actual message text
    - timestamp: When the message was sent
    - additional_context: Extra information like reasoning steps (for AI messages)

## List the sessions

 - [GET /core/v1/sessions](https://api.docs.wabee.ai/openapi/sessions/list_sessions_core_v1_sessions_get.md): Returns a paginated list of all available chat sessions.
    
    The response includes:
    - List of session summaries
    - Pagination information
    - Total count of returned sessions
    
    Each session summary contains:
    - session_id: Unique identifier for the session
    - checkpoint_id: Internal reference ID
    - short_name: Brief description based on first message
    
    Use the query parameters to navigate through pages:
    - before: Get sessions before this session ID
    - limit: Number of sessions per page (1-50)
    
    Sessions are ordered by most recent first.
    Empty sessions (no messages) are automatically filtered out.