Skip to main content
POST
/
v1
/
memory
curl -X POST https://api.velixarai.com/v1/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"]
  }'

{
  "id": "mem_abc123",
  "stored": true
}

​
Request body

​
content
string
required
The memory content. This text is embedded for semantic search.
​
user_id
string
User ID for multi-user isolation. Memories are scoped to this user.
​
tier
integer
default:"2"
Storage tier: 0 (pinned), 1 (session), 2 (semantic), 3 (organization).
​
type
string
Memory type: fact, preference, context, or any custom string.
​
tags
string[]
Tags for filtering.
​
metadata
object
Arbitrary key-value metadata.

​
Response

​
id
string
The unique memory ID (UUID).
​
stored
boolean
Whether the memory was successfully stored.
curl -X POST https://api.velixarai.com/v1/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"]
  }'

{
  "id": "mem_abc123",
  "stored": true
}