API REFERENCE

Search memories

Run direct memory search across the active organization, including link-description hits when graph search is enabled.

Requires authentication — a Bearer token or X-Memuron-Actor-Id header.

Body parameters

querystringrequired

kintegeroptional

scopestring[]optional

Ranking is hybrid: pgvector cosine fused with Postgres full-text via Reciprocal Rank Fusion.

POST/memuron/memories/search

curl -X POST https://api.memuron.com/memuron/memories/search \
  -H "Content-Type: application/json"

import requests, os

res = requests.post(
    "https://api.memuron.com/memuron/memories/search",
    headers={"Authorization": f"Bearer {os.environ['MEMURON_KEY']}}"},
    json={},
)
print(res.json())

const res = await fetch("https://api.memuron.com/memuron/memories/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
});
const data = await res.json();

200 OK

{
  "status": "success",
  "count": 1,
  "results": [
    {
      "id": "9c1f…",
      "content": "prefers dark mode",
      "matched_via": "memory"
    }
  ]
}