{"uid":"cap_5ssW7uWJvABeUlZGx7zWT","slug":"agent-long-term-memory-write-key-value-store-8be39dd1","name":"Agent Long-Term Memory Write (Key-Value Store)","description":"Long-term memory store for agents: write a key-value entry namespaced to your payer wallet (reads/search free)","url":"https://predator-ubuntu.taild9a745.ts.net/v1/memory/write?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","maxLength":256},"value":{"type":"string","maxLength":102400},"ttl_days":{"type":"integer","maximum":365,"minimum":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WIPUcCXDfumwQqlVhFHGO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Persists a key-value entry in a namespaced long-term memory store scoped to the calling agent's payer wallet, with optional TTL.","exampleAgentPrompt":"Save a memory entry with the key 'user_preferences' and the value '{\"theme\":\"dark\",\"language\":\"en\"}' to my agent's long-term memory store, and keep it for 90 days.","exampleUseCases":[{"title":"Persisting agent session state","prompt":"Store the key 'last_session_context' with the value 'User was researching quantum computing papers and asked about decoherence' in my agent's memory for 30 days so I can pick up where I left off next time."},{"title":"Saving scraped research results","prompt":"Write a memory entry with key 'competitor_pricing_snapshot' and value containing the pricing table I just collected, and keep it for 7 days so I can compare it to next week's snapshot."},{"title":"Storing agent configuration preferences","prompt":"Save my agent's config under the key 'agent_config_v2' with value '{\"max_retries\":3,\"timeout_ms\":5000,\"preferred_model\":\"gpt-4o\"}' and make it last for a full year."}],"resultDescription":"A confirmation that the key-value entry has been written to the agent's wallet-namespaced memory store, including the key stored and the effective TTL. Reads and searches against this data are free; only writes incur the $0.01 USDC charge.","failureModes":["Key exceeds 256-character limit — rejected with validation error","Value exceeds 100KB limit — rejected with payload-too-large error","TTL outside 1–365 range — rejected with validation error","Payment not settled or insufficient USDC balance — 402 Payment Required returned","Tailnet host unreachable — connection timeout or network error"],"whenToPreferThis":"Use this endpoint when your agent needs to persist state, context, or data across sessions and wants it namespaced automatically to its payer wallet without managing a separate database. Ideal for lightweight agent memory (configs, preferences, intermediate results, research snapshots) up to 100KB per entry with a configurable TTL up to one year. Prefer this over general-purpose databases when you want zero-setup persistent memory billed per write with free reads/search.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:35:47.994Z","isFirstParty":false,"canonicalSlug":"agent-long-term-memory-write-key-value-store-8be39dd1"}