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."
}

curl -X DELETE "https://mengram.io/v1/account?confirm=you@example.com" \
  -H "Authorization: Bearer om-..."

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

{"query": "what does this customer prefer?", "user_id": "cust_1042", "limit": 5, "max_tokens": 600}

{
  "results": [...],
  "budget": {
    "max_tokens": 600, "used_tokens": 512, "method": "estimate",
    "kept":    {"entities": 3, "facts": 14},
    "dropped": {"entities": 2, "facts": 9, "relations": 1, "knowledge": 2}
  }
}

{
  "entity": "app", "type": "project", "score": 0.91,
  "facts": ["deploys to Fly.io from main", "uses PostgreSQL 16"],
  "facts_meta": [
    {"source": "codex", "os": "linux", "cwd": "/home/ali/app", "session": "s-41",
     "when": "2026-09-15", "recalled": 3, "last_recalled": "2026-09-16"},
    {"source": "api", "when": "2026-09-10", "recalled": 0}
  ]
}

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

{
  "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"}

curl -X POST "https://mengram.io/v1/identity?entity=YourName" \
  -H "Authorization: Bearer om-..."

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

curl -X DELETE "https://mengram.io/v1/reflections/<id>" \
  -H "Authorization: Bearer om-..."

{
  "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"}

{
  "message": {
    "type": "tool-calls",
    "toolCallList": [{
      "id": "call_abc",
      "name": "recall_caller",
      "arguments": { "phone": "+15551234567" }
    }],
    "call": {
      "customer": { "number": "+15551234567" }
    }
  }
}

{
  "message": {
    "type": "tool-calls",
    "toolCalls": [{
      "id": "call_abc",
      "type": "function",
      "function": {
        "name": "recall_caller",
        "arguments": "{\"phone\": \"+15551234567\"}"
      }
    }]
  }
}

{
  "results": [{
    "toolCallId": "call_abc",
    "result": "Known about caller (Sarah Johnson): Sarah Johnson: prefers morning slots before 11 AM | Sarah Johnson: gets anxiety with novocaine"
  }]
}

{
  "message": {
    "type": "end-of-call-report",
    "endedReason": "customer-ended-call",
    "call": {
      "id": "...",
      "customer": { "number": "+15551234567" }
    },
    "transcript": "Agent: ...\nCaller: ..."
  }
}

{
  "status": "accepted",
  "job_id": "job-xxxx",
  "sub_user_id": "voice:+15551234567"
}

{"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"}