Recommendations
recommendations

Get Memory Recommendations

Get personalized memory recommendations.

Returns up to N similar memories ranked by:

  • 50% Semantic Similarity (from graph relationships)
  • 20% Recency (recently created/updated memories)
  • 20% Interaction (views, edits, shares)
  • 10% Feedback (user upvotes on past recommendations)

Query Parameters:

  • memory_id: Memory to get recommendations for (path)
  • org_id: Organization ID
  • limit: Number of recommendations (1-50, default 10)
  • min_similarity: Minimum relationship similarity (0.0-1.0)
  • max_age_days: Exclude memories older than N days
  • use_cache: Use cached results if available (default true)

Returns:

  • recommendations: List of ranked memories with scores and factors
  • memory_id: Input memory ID
  • count: Number of recommendations returned
get/api/v1/memories/{memory_id}/recommendations

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Path parameters

memory_idstring required

Query parameters

org_idstring required
limitinteger
min_similaritynumber
max_age_daysinteger nullable
use_cacheboolean

Headers

X-API-Keystring nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.