API Reference

Base URL

https://mengram.io

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer om-your-api-key

Core endpoints

POST /v1/add

Add memories from a conversation.

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

Response: {{"status": "accepted", "job_id": "job-..."}}

POST /v1/add_text

Add memories from plain text.

{{"text": "Meeting notes: migrating to PostgreSQL 16", "user_id": "default"}}

POST /v1/search

Semantic search across the knowledge graph.

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

POST /v1/search/all

Unified search across all 3 memory types.

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

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

GET /v1/memories

List all entities for a user.

GET /v1/memory/:name

Get details for a specific entity.

DELETE /v1/memory/:name

Delete an entity.

Cognitive Profile

GET /v1/profile

Generate a Cognitive Profile system prompt.

Query params: force=true to regenerate, sub_user_id for multi-user.

Episodic Memory

GET /v1/episodes

List recent episodes. Params: limit, after, before.

GET /v1/episodes/search

Search episodes. Params: query, limit, after, before.

Procedural Memory

GET /v1/procedures

List procedures. Params: limit.

GET /v1/procedures/search

Search procedures. Params: query, limit.

PATCH /v1/procedures/:id/feedback

Record success/failure. Params: success=true|false. Body: {{"context": "...", "failed_at_step": 3}}

GET /v1/procedures/:id/history

Get version history for a procedure.

Memory Management

POST /v1/dedup

Find and merge duplicate entities.

POST /v1/merge

Merge two entities. Params: source, target.

POST /v1/archive_fact

Archive a specific fact. Body: {{"entity_name": "...", "fact_content": "..."}}

POST /v1/agents/run

Run memory agents. Params: agent=all|curator|connector|digest, auto_fix=true|false.

Jobs

GET /v1/jobs/:id

Check status of a background job. Response: {{"status": "completed|processing|failed", ...}}

Webhooks

POST /v1/webhooks

Create a webhook. Body: {{"url": "...", "event_types": ["memory_add"]}}

GET /v1/webhooks

List all webhooks.

For interactive API docs, see Swagger UI or ReDoc.