/ api

Your brain. Every app.

Any agent that speaks HTTP can read and write your memory. One API key, user-scoped, rate-limited, auditable.

100ms
median latency
1k/min
rate limit
json
request format
scoped
per-user keys
§01 · ENDPOINT

Ask your brain a question.

Semantic search over your full memory graph. Returns the answer, confidence, and the memories it cited.

POST/v1/brain/ask
v1-brain-ask.sh
curl -X POST https://api.mybrain.ai/v1/brain/ask \
  -H "Authorization: Bearer mbk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"question": "What are my dietary preferences?"}'

# Response
{
  "answer": "You prefer vegetarian. Allergic to peanuts. Love Thai (47 mentions).",
  "confidence": "high",
  "sources": ["preferences/food.md", "conversations/2024-09-11.md"]
}
§02 · ENDPOINT

Write a memory.

Append a fact to your vault. Deduped against your graph automatically. Scored, tagged, and indexed.

POST/v1/memory/write
v1-memory-write.sh
curl -X POST https://api.mybrain.ai/v1/memory/write \
  -H "Authorization: Bearer mbk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Atlas launch retro moved to Thursday 2pm.",
    "tags": ["work", "atlas launch"],
    "source": "claude-code"
  }'

# Response
{
  "id": "mem_8f3c7a91e2b04d",
  "deduped": false,
  "cluster": "work · atlas launch"
}
§03 · ENDPOINT

Search memories by keyword or tag.

Full-text + vector hybrid search. Filter by tag, source, or recency. Paginated.

GET/v1/memory/search
v1-memory-search.sh
curl "https://api.mybrain.ai/v1/memory/search?q=running&tag=health" \
  -H "Authorization: Bearer mbk_live_..."

# Response
{
  "memories": [
    {"id": "m6", "text": "Right shoulder soreness after long runs.", "when": "3h ago"},
    {"id": "m11", "text": "Saucony Endorphin Speed 4.", "when": "2d ago"}
  ],
  "total": 2,
  "next_cursor": null
}
§04 · ENDPOINT

Pipe anything into your brain.

Forward Slack, Linear, Stripe — any service that speaks HTTP. mybrain extracts what matters.

POST/v1/webhook
v1-webhook.sh
curl -X POST https://api.mybrain.ai/v1/webhook/your-key \
  -H "Content-Type: application/json" \
  -d '{
    "event": "issue.closed",
    "payload": { "title": "Ship Atlas redesign", "actor": "you" }
  }'

# Response
{
  "ingested": true,
  "memories_written": 1
}
§05 · AUTH

Bearer tokens. Scoped to you.

Generate as many keys as you need from your dashboard. Revoke any one at any time. Every call is logged in your activity feed.

01

Per-user scope

Every key writes to one brain. No cross-account access. Server-side enforced at every layer.

02

Rate limited

1,000 requests/min on Plus, 100/min on BYO. Burst-friendly. Soft fail when exceeded.

03

Audit log

Every read and write shows up in /activity with the source agent, timestamp, and payload size.

04

Revocable

Kill any key from /settings/developer. Active sessions terminate within 5 seconds.

05

TLS only

All traffic forced over TLS 1.3. Cleartext requests are rejected at the edge.

06

No training

Calls aren't logged for training. Your data and queries stay yours, period.

Pipe everything into your brain.

mybrain · a silverline product · © 2026