Skip to main content

​
1. Get your API key

Sign up at velixarai.com and create an API key from Settings → API Keys. Keys start with vlx_.

​
2. Store a memory

curl -X POST https://api.velixarai.com/memory \
  -H "Authorization: Bearer vlx_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "User prefers dark mode and metric units",
    "user_id": "user_123",
    "tier": 0,
    "type": "preference",
    "tags": ["settings", "ui"]
  }'

​
3. Search memories

curl "https://api.velixarai.com/memory/search?q=user%20preferences&limit=5" \
  -H "Authorization: Bearer vlx_your_key"
Response: 
{
  "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
}

​
Next steps

Memory tiers

Learn how to organize memories by importance

Auto-extraction

Let Velixar extract memories from conversations automatically