{"uid":"cap_IURuGB15VPKte6W8Q1urV","slug":"memory-withzero-xyz-remember-a-fact-in-durable-agent-memory-dcb7cbae","name":"Remember a Fact in Durable Agent Memory","description":"Remember a fact or context in durable agent memory.","url":"https://memory.withzero.xyz/api/v1/memories","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["content"],"properties":{"ns":{"type":"string","maxLength":128,"minLength":1,"description":"Namespace under the caller (e.g. agent:coder). Defaults to \"default\"."},"key":{"type":"string","maxLength":256,"minLength":1,"description":"Caller-chosen key, unique per (owner, ns). Omit to auto-generate."},"tags":{"type":"array","items":{"type":"string"},"maxItems":32,"description":"Optional tags for later filtering."},"pinned":{"type":"boolean","description":"Mark as a \"standing order\": always surfaced by recall and never consolidated/suppressed by dreaming. Omit on update to leave it unchanged."},"content":{"type":"string","maxLength":8192,"minLength":1,"description":"The memory text to remember."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","key","billing_rail","replayed","balance_micros"],"properties":{"id":{"type":"string"},"key":{"type":"string"},"replayed":{"type":"boolean"},"billing_rail":{"enum":["direct","zeroclick"],"type":"string"},"balance_micros":{"type":"string","description":"Remaining refundable direct-rail prepaid balance in USDC micros. ZeroClick usage never changes it."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","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":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_faFKe7uP9Ag9B97DaZRH_","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"memory.remember:1"}],"brandName":"memory.withzero.xyz","brandSlug":"memory-withzero-xyz-mpp","brandBaseUrl":"https://memory.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Stores a text memory (fact, context, or standing order) into durable, private agent memory with optional namespace, key, tags, and pinning.","exampleAgentPrompt":"Remember this for me durably: 'The user prefers concise responses and always wants output in bullet points.' Pin it as a standing order under namespace 'agent:preferences' with key 'response-style' and tag it as 'formatting'.","exampleUseCases":[{"title":"Save user dietary restrictions permanently","prompt":"Remember this for me durably: 'The user is strictly vegan and has a severe peanut allergy.' Pin it as a standing order under namespace 'user:health' with key 'dietary-restrictions' and tag it as 'preferences' and 'safety'."},{"title":"Persist project deadline across sessions","prompt":"Store this context so I can recall it later: 'The Q3 product launch deadline is September 30th and the primary stakeholder is Maria Chen.' Save it under namespace 'project:launch' with key 'q3-deadline' and tag it as 'deadlines' and 'stakeholders'."},{"title":"Save standing tone instruction for agent","prompt":"Remember this as a pinned standing order: 'Always respond to this client in a formal, professional tone and never use casual language or contractions.' Store it under namespace 'client:comms' with key 'tone-guidelines' and tag it as 'style' and 'standing-order'."}],"resultDescription":"Returns the memory's assigned ID, the key (caller-supplied or auto-generated), and the remaining prepaid USDC balance in micros after the write operation.","failureModes":["Missing required 'content' field returns a 400 validation error","Content exceeding 8192 characters is rejected","Key collisions under the same (owner, ns) pair may overwrite or error","Insufficient prepaid balance may block the write","Namespace or key strings exceeding length limits are rejected","More than 32 tags supplied returns a validation error"],"whenToPreferThis":"Use this endpoint when you need to persist a fact, preference, instruction, or context durably across agent sessions, especially when you want namespaced organization, tagging for later recall, or pinned 'standing orders' that always surface during recall. Prefer this over in-context storage when information must survive beyond the current conversation or be retrievable by a separate recall query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:25.484Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:56.367Z","isFirstParty":true}