Skip to main content
GET
/
v1
/
memory
/
search
curl "https://api.velixarai.com/memory/search?q=user%20preferences&limit=5" \
  -H "Authorization: Bearer vlx_your_key"

{
  "memories": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": "User prefers dark mode and metric units",
      "score": 0.9215,
      "tier": 0,
      "type": "preference",
      "tags": ["settings", "ui"],
      "salience": 0.85,
      "created_at": "2026-02-16T10:30:00Z"
    }
  ],
  "count": 1
}

​
Query parameters

​
q
string
required
Natural language search query.
​
user_id
string
Filter results to a specific user.
​
limit
integer
default:"10"
Maximum number of results (1–100).
​
tiers
string
default:"0,1,2,3"
Comma-separated tier filter. Example: 0,2 for pinned + semantic only.

​
Response

​
memories
array
Array of matching memories, sorted by relevance score.
​
count
integer
Number of results returned.
curl "https://api.velixarai.com/memory/search?q=user%20preferences&limit=5" \
  -H "Authorization: Bearer vlx_your_key"

{
  "memories": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": "User prefers dark mode and metric units",
      "score": 0.9215,
      "tier": 0,
      "type": "preference",
      "tags": ["settings", "ui"],
      "salience": 0.85,
      "created_at": "2026-02-16T10:30:00Z"
    }
  ],
  "count": 1
}