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": [...]
}

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