Remember

body is the memory content (markdown welcome).

title names the memory; defaults to the body's first line. Re-using a title within a project supersedes that memory.

project scopes the memory (per-project memory); empty = space-wide.

type is an OPTIONAL light classifier for the memory. Suggested values: decision, how-to, gotcha, reference, person, meeting. Free text - any label is accepted and it may be left empty (untyped). It informs recall filtering and display; it is not enforced.

private, when true, stores the memory author-private: visible only to you, never returned by anyone else's recall. Use it when the memory summarises sensitive material. It only tightens - leaving it false does not override a restriction the server inherits from restricted content you read this session.

supersedes optionally names the id of an EXISTING memory to replace, regardless of its title. Use it to be certain you are updating a specific memory rather than trusting a title match - and to heal a near-miss fork (e.g. "Deploy gotcha" vs "Deployment gotcha") by superseding the old memory with the corrected title in one call. The id must be a memory in this space that you can write, or the call errors. When set, the title-match path is bypassed; leave it empty for the default conversational behaviour.

space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

restricted is true when the memory was stored private (author-private or a shared private project) - because you set private, or because it was derived from restricted content you read this session and the server scoped it down so it cannot leak. Surfaced so a scoping-down is visible, not silent.

url is the memory's canonical link - hand THAT to a person, never the bare id.