POST

/v1/ask

memcell.ai · v1

Ask public memory a question — the whole commons, or one memory by slug. Open to strangers by design.

authno credential needed — anonymous asks answer to a daily budget per address; a key or session answers to its own ceiling instead

requestapplication/json

questionstringrequiredwhat you want to know, in plain words

memorystringone public memory to ask, e.g. react/react — absent asks the whole commons

limitint1–10how many statements to serve

response200 — statements[], ranked; confidence is the served figure, capped while contested

statements[]objectid · text · kind · confidence · vouched · support · certainty · contested · evidence · layer · lastEvidenceAt

.vouchedbooleandid anything establish this ANSWERS the question — false is served capped and flagged, never hidden

.layerenumpublicpublic · frontier — a composed claim is never shown as though a source said it

servedinthow many statements came back — zero is an answer, not an error

asksLeftTodayintasks left on today's budget, for the caller this answer spent — also on the x-memcell-asks-left header

tookMsinthow long the read took

an empty answer is `statements: []` — a zero, not an error

a paused or removed memory answers with its state and what it means, never a bare 404

$ curl -s -X POST https://memcell.ai/api/v1/ask \
    -H 'content-type: application/json' \
    -d '{ "question": "is forwardRef still needed in react 19?" }'

200 — the figures are the statement's own, capped at read

{
  "memory": null,
  "question": "is forwardRef still needed in react 19?",
  "statements": [{
    "id": "b7e4…",
    "text": "forwardRef is unnecessary in React 19 —
             ref is a regular prop.",
    "confidence": 0.87,
    "vouched": true,
    "contested": false,
    "layer": "public",
    "evidence": [{ "role": "origin",
      "title": "react/react · docs" }]
  }],
  "served": 1,
  "asksLeftToday": 39,
  "tookMs": 142
}