Get Context

Retrieve AI context including relevant memories and recent conversations.

Generate context for LLM prompts by retrieving the most relevant memories and recent messages for a user. Use this to manually inject memory context into your AI applications.

Path Parameters:

• custom_user_id (str): Unique identifier for the user
• session_id (UUID): Session UUID to get context from

Query Parameters:

• recall_strategy (RecallStrategy): Memory retrieval strategy. Options: low_latency, balanced, agentic and auto. Default: balanced
• min_top_k (int): Minimum number of memories to return. Range: 5-50. Default: 15
• max_top_k (int): Maximum number of memories to return. Range: 10-100. Default: 50
• memories_threshold (float): Similarity threshold for memories. Range: 0.2-0.8. Default: 0.6
• summaries_threshold (float): Similarity threshold for session summaries. Range: 0.2-0.8. Default: 0.5
• last_n_messages (int): Number of last messages to include in context. Range: 1-100. Optional
• last_n_summaries (int): Number of last summaries to include in context. Range: 1-20. Optional
• timezone (str): Timezone for formatting timestamps (e.g., ‘America/New_York’). Default: UTC
• include_system_prompt (bool): Whether to include the default system prompt. Default: true
• stream (bool): Whether to stream status updates via Server-Sent Events. Default: false

Returns:

• When stream=false: JSON GetContextResponse with is_final=true and context field
• When stream=true: SSE stream of GetContextResponse events with progress updates, ending with a final event containing the context