POST /query/temporal

When to use

Use temporal query when users ask what was true at a specific time, or when you need only the most recent period of activity.

This endpoint is useful for compliance, debugging, and user-facing activity summaries.

Window controls

• Window boundaries are inclusive.
• Out-of-window memories are excluded before final ranking.
• Temporal filters combine with kind filters if provided.

{
  "entity_id": "user-123",
  "textual_query": "where did I live?",
  "window_start_ms": 1751328000000,
  "window_end_ms": 1767225599000,
  "limit": 10
}

Interpretation

Temporal windows answer a different question than decay. Decay softly biases relevance toward freshness, while windows enforce hard time boundaries.