{"uid":"cap_z4K6AUIO0wycZtolYAdj1","slug":"mnemo-memory-write-post-v1-memory-remember-e9edfad5","name":"Mnemo Memory Write — POST /v1/memory/remember","description":"Memory that belongs to the user and follows them across agents. The agent pays per call (x402); the user authorizes the agent once: POST /v1/memory/delegate/challenge {user, agent} returns text the user signs (EIP-191), then POST /v1/memory/delegate {..., signature} returns a bearer token. Send Authorization: Bearer mn_... on every memory call. Start a session with GET /v1/memory/profile, write with POST /v1/memory/remember, retrieve with POST /v1/memory/recall (hybrid vector + keyword). When the user contradicts a memory, POST /v1/memory/conflict supersedes it with history kept. Tier B stores client-side ciphertext the server cannot read. Export and forget are always free.","url":"https://memory.reversecaptcha.fun/v1/memory/remember?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ttl":{"type":"number","description":"seconds until the memory turns stale"},"kind":{"enum":["fact","preference","instruction","decision","state"]},"tags":{"type":"array","items":{"type":"string"}},"tier":{"enum":["A","B"]},"source":{"type":"string"},"content":{"type":"string"},"ciphertext":{"type":"string"},"confidence":{"type":"number"},"blind_index":{"type":"array","items":{"type":"string"}}}},"responseSchema":{"type":"json","example":{"memory_id":"mem_...","deduplicated":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n_Svz7fMWEU57vJjAtd6h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Writes a typed, tagged memory entry for a user that persists across agents, supporting optional client-side encryption (Tier B) and automatic deduplication.","exampleAgentPrompt":"Remember for me that I prefer dark mode in all apps and I'm lactose intolerant — store these as user preferences (kind: preference) with tags ['ui','dietary'] that never expire, using standard Tier A storage.","exampleUseCases":[{"title":"Persist dietary restriction across agents","prompt":"Save the fact that I'm vegetarian and allergic to nuts as a permanent user preference with tags 'dietary' and 'health' — I want every agent I use to know this automatically."},{"title":"Store expiring session state for a workflow","prompt":"Remember my current checkout cart state — items: ['blue hoodie size M', 'white sneakers size 10'] — as a 'state' memory with tags ['cart','shopping'] that expires in 3600 seconds so we can resume if I get disconnected."},{"title":"Write an encrypted private instruction","prompt":"Store a private instruction for me in Tier B encrypted storage: 'Never share my home address with third-party services.' Tag it 'privacy' and 'instruction', kind instruction, so only I can decrypt it."}],"resultDescription":"Returns a JSON object containing a unique memory_id (e.g. 'mem_...') and a deduplicated boolean indicating whether the write was merged with an existing equivalent memory rather than creating a new entry.","failureModes":["Missing or invalid Bearer token (mn_...) returns 401 Unauthorized","Payment not settled via x402 returns 402 Payment Required","Invalid 'kind' enum value returns 400 Bad Request","Tier B write missing required ciphertext or blind_index fields returns 400","TTL value is not a positive number returns 400","Content field is empty or absent returns 400","Server-side error during vector indexing returns 500"],"whenToPreferThis":"Use this endpoint when an AI agent needs to durably persist user-specific facts, preferences, instructions, decisions, or state that should survive across multiple agent sessions or different agents. Prefer Mnemo over ad-hoc in-context memory when the user's memory must be portable, owner-controlled, and retrievable via semantic search later. Choose Tier B if the content is sensitive and must remain opaque to the server.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:00:17.169Z","isFirstParty":false,"canonicalSlug":"mnemo-memory-write-post-v1-memory-remember-e9edfad5"}