Quick Start - MemoryX

1. Register an Account

cURL
Python
JavaScript

curl -X POST https://t0ken.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "securepassword123"
  }'

import requests

response = requests.post(
    "https://t0ken.ai/api/auth/register",
    json={
        "email": "user@example.com",
        "password": "securepassword123"
    }
)

print(response.json())
# {"id": 1, "email": "user@example.com"}

const response = await fetch('https://t0ken.ai/api/auth/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'securepassword123'
  })
});

const data = await response.json();
console.log(data);
// { id: 1, email: "user@example.com" }

cURL
Python

curl -X POST https://t0ken.ai/api/auth/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=user@example.com&password=securepassword123"

response = requests.post(
    "https://t0ken.ai/api/auth/login",
    data={
        "username": "user@example.com",
        "password": "securepassword123"
    }
)

token = response.json()["access_token"]

3. Get Your API Key

curl https://t0ken.ai/api/keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Default",
      "key": "omx_xxxxxxxxxxxxxxxxxxxxxxxx",
      "is_active": true
    }
  ]
}

4. Create Your First Memory

cURL
Python

curl -X POST https://t0ken.ai/api/v1/memories \
  -H "Content-Type: application/json" \
  -H "X-API-Key: omx_your_api_key" \
  -d '{
    "content": "User prefers dark mode in all applications",
    "project_id": "default",
    "metadata": {
      "source": "user_settings",
      "importance": "high"
    }
  }'

response = requests.post(
    "https://t0ken.ai/api/v1/memories",
    headers={"X-API-Key": "omx_your_api_key"},
    json={
        "content": "User prefers dark mode in all applications",
        "project_id": "default",
        "metadata": {"source": "user_settings"}
    }
)

print(response.json())
# {
#   "success": true,
#   "task_id": "abc123...",
#   "status": "pending"
# }

5. Search Memories

curl -X POST https://t0ken.ai/api/v1/memories/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: omx_your_api_key" \
  -d '{
    "query": "user preferences",
    "limit": 10
  }'

Next Steps

API Reference

Explore all available endpoints

Core Concepts

Learn about memories, projects, and cognitive sectors

Integrations

Integrate with Cursor, OpenClaw, and more