API Reference

https://mengram.io

Authorization: Bearer om-your-api-key

curl -X POST https://mengram.io/v1/add \
  -H "Authorization: Bearer om-..." \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "I use Python and Railway"},
      {"role": "assistant", "content": "Noted."}
    ],
    "user_id": "default"
  }'

{"text": "Meeting notes: migrating to PostgreSQL 16", "user_id": "default", "source": "slack", "metadata": {"channel": "#engineering"}}

curl -X POST https://mengram.io/v1/add_file \
  -H "Authorization: Bearer om-..." \
  -F "file=@meeting-notes.pdf" \
  -F "user_id=default"

{
  "status": "accepted",
  "job_id": "job-...",
  "file_type": "pdf",
  "page_count": 12,
  "quota_used": 12,
  "message": "Processing meeting-notes.pdf (12 pages/chunks) in background."
}

{"query": "database preferences", "user_id": "default", "limit": 5, "graph_depth": 2}

{"query": "deployment", "user_id": "default", "limit": 5}

{
  "semantic": [...],
  "episodic": [...],
  "procedural": [...]
}

curl -X POST https://mengram.io/v1/ask \
  -H "Authorization: Bearer om-..." \
  -H "Content-Type: application/json" \
  -d '{"query": "what programming languages do I use?", "user_id": "default"}'

{
  "answer": "You use Python and Rust. Python is your daily language and Rust is your favorite. You also use Java for enterprise systems.",
  "citations": [
    {
      "text": "Python and Rust",
      "start": 8,
      "end": 23,
      "sources": [
        {"entity": "Python", "fact": "uses Python daily for backend development"},
        {"entity": "Rust", "fact": "Rust is favorite language"}
      ]
    },
    {
      "text": "Java for enterprise systems",
      "start": 92,
      "end": 119,
      "sources": [
        {"entity": "Ali Baizhanov", "fact": "specializes in Java/Spring Boot for enterprise"}
      ]
    }
  ],
  "facts_used": 22
}

{"type": "technology"}

{"entity_name": "PostgreSQL", "fact_content": "Uses version 15"}

{
  "url": "https://your-app.com/hook",
  "name": "Production",
  "event_types": ["memory_add", "memory_update", "memory_delete"],
  "secret": "your-hmac-secret"
}

{"name": "Engineering", "description": "Shared engineering memory"}

{"invite_code": "abc123"}

{"entity_name": "PostgreSQL"}

{"name": "production-key"}

{"name": "new-name"}

{"plan": "pro"}

{"detail": "Invalid API key"}

{
  "error": "quota_exceeded",
  "action": "add",
  "limit": 50,
  "used": 50,
  "plan": "free",
  "upgrade_url": "https://mengram.io/checkout?token=...",
  "message": "Monthly add limit reached (50). Upgrade to Starter ($5/mo) at ...",
  "retry_after": 864000
}

{"detail": "Rate limit exceeded"}