Skip to main content
GET
/
v1
/
memory
/
search
curl "https://api.velixarai.com/v1/memory/search?q=user%20preferences&limit=5" \
  -H "Authorization: Bearer vlx_your_key"
{
  "memories": [
    {
      "id": "mem_abc123",
      "content": "User prefers dark mode and metric units",
      "tier": 0,
      "type": "preference",
      "score": 0.92,
      "tags": ["settings", "ui"],
      "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/v1/memory/search?q=user%20preferences&limit=5" \
  -H "Authorization: Bearer vlx_your_key"
{
  "memories": [
    {
      "id": "mem_abc123",
      "content": "User prefers dark mode and metric units",
      "tier": 0,
      "type": "preference",
      "score": 0.92,
      "tags": ["settings", "ui"],
      "created_at": "2026-02-16T10:30:00Z"
    }
  ],
  "count": 1
}