Recall memories

Hybrid vector + graph recall. Returns the most relevant memories for the query.

GET /v1/memories/recall

Recall memories

cURL

curl --request GET \
  --url http://localhost:8080/v1/memories/recall \
  --header 'Authorization: Bearer <token>'

200

{
  "memories": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "content": "<string>",
      "confidence": 0.5,
      "reinforcement_count": 123,
      "access_count": 123,
      "decay_rate": 123,
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "score": 123
    }
  ],
  "query": "<string>",
  "count": 123
}

Authorizations

Authorization · string · header · required

API key with mk_ or rk_ prefix

Query Parameters

agent_id · string<uuid> · required

query · string · required

top_k · integer · default: 10

Required range: x <= 100

type · enum<string>

Available options: preference, fact, decision, constraint

min_confidence · number<float> · default: 0.6

graph_weight · number<float> · default: 0.4

0–1 blend weight for graph traversal vs. vector search

max_hops · integer · default: 2

Response

200 - application/json

Recalled memories

memories · object[]

Show child attributes

query · string

count · integer