Query Memory API

[!NOTE] This reference is for the Backend Server API. If you are using Standalone Mode, use the JavaScript SDK or Python SDK directly.

Search for relevant memories using semantic similarity and graph traversal.

Endpoint

POST /memory/query

Request Body

interface QueryMemoryRequest {
  query: string;
  k?: number; // Number of results (default: 5)
  user_id?: string;
  min_score?: number; // Minimum similarity score (0-1)
}

Example

curl -X POST http://localhost:8080/memory/query \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "query": "What are the user preferences?",
    "k": 3
  }'

Response

{
  "query": "What are the user preferences?",
  "matches": [
    {
      "id": "mem_abc123",
      "content": "User prefers dark mode",
      "score": 0.89,
      "primary_sector": "semantic"
    }
  ]
}