Signed-in quickstart

API Quickstart (cURL)

Terminal-only flow. Sign in to the portal first, then copy your API key from the Keys tab into MI_KEY.

Response envelope

Successful calls return status, data, request_id, and timestamp. Read payloads from data (e.g. data.umo_id, data.results[]).

1 — Health check

curl -s https://api.memoryintelligence.io/health | python3 -m json.tool

2 — Configure

export MI_KEY="mi_sk_beta_your_key_here"
export MI_URL="https://api.memoryintelligence.io"

Get MI_KEY from portal → Keys.

3 — Capture

curl -X POST "$MI_URL/v1/memories" \
  -H "Authorization: Bearer $MI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Had coffee with Sarah. She mentioned a seed round.","source":"quickstart"}'

Save data.umo_id from the response.

4 — List memories

curl -s "$MI_URL/v1/memories?limit=10" \
  -H "Authorization: Bearer $MI_KEY" | python3 -m json.tool

5 — Search

curl -X POST "$MI_URL/v1/memories/query" \
  -H "Authorization: Bearer $MI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What do I know about funding?","limit":5}'

6 — Explain & verify

export UMO_ID="paste_data.umo_id_here"
curl -s "$MI_URL/v1/memories/$UMO_ID/explain" -H "Authorization: Bearer $MI_KEY" | python3 -m json.tool
curl -s "$MI_URL/v1/memories/$UMO_ID/proof" -H "Authorization: Bearer $MI_KEY" | python3 -m json.tool