Get Started in 5 Minutes

Everything you need to start saving and searching AI memories with the MNEMO API.

1

Get Your API Key

Every API request requires an API key passed in the X-MNEMO-Key header. If you have not signed up yet, create your account first.

Need an API key? Sign up here to get your key in under 2 minutes. Your key starts with mnk_ and is shown only once at creation.

2

Make Your First Call

Verify your setup by checking your account stats. Replace YOUR_API_KEY with your actual key.

Python
JavaScript
cURL
import requests

# Replace with your actual API key
API_KEY = "mnk_your_api_key_here"
BASE = "https://api.tds-automation.com/api/v1/mnemo"

response = requests.get(
    f"{BASE}/stats",
    headers={"X-MNEMO-Key": API_KEY}
)
print(response.json())
const API_KEY = "mnk_your_api_key_here";
const BASE = "https://api.tds-automation.com/api/v1/mnemo";

const res = await fetch(`${BASE}/stats`, {
  headers: { "X-MNEMO-Key": API_KEY }
});
const data = await res.json();
console.log(data);
curl -s https://api.tds-automation.com/api/v1/mnemo/stats \
  -H "X-MNEMO-Key: mnk_your_api_key_here" | python -m json.tool
Example Response
{
  "tenant_id": "my-company",
  "plan": "pro",
  "memories_count": 0,
  "api_calls_today": 1,
  "api_calls_limit": 1000
}
3

Save Your First Memory

Store a decision, lesson, event, or error in your AI memory. Each memory gets a semantic embedding for intelligent retrieval.

Python
JavaScript
cURL
response = requests.post(
    f"{BASE}/save",
    headers={"X-MNEMO-Key": API_KEY},
    json={
        "type": "decision",
        "text": "Chose pgvector for embeddings because it integrates natively with PostgreSQL and avoids a separate vector DB.",
        "tags": ["architecture", "database"]
    }
)
print(response.json())
# {"id": 1, "type": "decision", "status": "saved"}
const res = await fetch(`${BASE}/save`, {
  method: "POST",
  headers: {
    "X-MNEMO-Key": API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    type: "decision",
    text: "Chose pgvector for embeddings because it integrates natively with PostgreSQL.",
    tags: ["architecture", "database"]
  })
});
console.log(await res.json());
curl -X POST https://api.tds-automation.com/api/v1/mnemo/save \
  -H "X-MNEMO-Key: mnk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "decision",
    "text": "Chose pgvector for embeddings.",
    "tags": ["architecture", "database"]
  }'
Example Response
{
  "id": 1,
  "type": "decision",
  "status": "saved",
  "embedding": true
}
4

Search Your Memories

Retrieve memories by keyword or semantic similarity. The ranking engine combines text match, recency, access frequency, and embedding distance.

Python
JavaScript
cURL
response = requests.get(
    f"{BASE}/search",
    headers={"X-MNEMO-Key": API_KEY},
    params={
        "q": "database architecture decision",
        "limit": 5,
        "semantic": "true"
    }
)
results = response.json()
for r in results["results"]:
    print(f"[{r['score']:.2f}] {r['text'][:80]}")
const params = new URLSearchParams({
  q: "database architecture decision",
  limit: "5",
  semantic: "true"
});

const res = await fetch(`${BASE}/search?${params}`, {
  headers: { "X-MNEMO-Key": API_KEY }
});
const { results } = await res.json();
results.forEach(r =>
  console.log(`[${r.score.toFixed(2)}] ${r.text.slice(0, 80)}`)
);
curl -s "https://api.tds-automation.com/api/v1/mnemo/search?q=database+architecture&limit=5&semantic=true" \
  -H "X-MNEMO-Key: mnk_your_api_key_here" | python -m json.tool
Example Response
{
  "query": "database architecture decision",
  "results": [
    {
      "id": 1,
      "type": "decision",
      "text": "Chose pgvector for embeddings...",
      "score": 0.94,
      "tags": ["architecture", "database"]
    }
  ],
  "count": 1,
  "semantic": true
}
5

Next Steps

You are up and running. Here is what to explore next.

Rate Limits by Plan

Plan Memories API Calls/Day Storage
Basic 1,000 100 100 MB
Pro 10,000 1,000 500 MB
Enterprise 100,000 10,000 5 GB
Create Account Sign up and get your API key
Dashboard Manage keys, usage, and billing
SDKs (Coming Soon) Python and Node.js libraries

Need help? Contact us at support@tds-automation.com or reach out via the admin panel.

MNEMO Platform by TDS AI Systems di Paolo Consorti. All rights reserved.