{"uid":"cap_3wIvncguNGlaDOnfUva0v","slug":"agent-data-tools-revmesh2074-workers-dev-agent-memory-read-recall-7716537e","name":"Agent Memory Recall: Read a Saved Value","description":"Read the value saved under a key in your namespace with /memory/set, with when it was saved and when it expires. A key that was never saved or has expired is a 404 and is not charged. Values are kept until they expire (at most 30 days) or are deleted; reads anywhere may lag a write made elsewhere by up to a minute. Use to recall what an agent saved in an earlier run.","url":"https://agent-data-tools.revmesh2074.workers.dev/memory/get?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["namespace","key"],"properties":{"key":{"type":"string","description":"The key, up to 200 characters"},"namespace":{"type":"string","description":"Your namespace: a secret of 16 to 128 letters, digits, - or _ that you choose and reuse. Anyone who knows it can read and write it, so treat it like a password; send it in a POST body to keep it out of URLs."}}},"responseSchema":{"type":"object","properties":{"key":{"type":"string"},"size":{"type":"number"},"value":{"type":"string"},"expiresAt":{"type":"string"},"updatedAt":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USD","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_gMLkC9MWyDimyMtW24vVw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Reads a previously saved key-value pair from an agent's persistent namespace, returning the value, its size, and expiry metadata.","exampleAgentPrompt":"Look up the value I saved under the key 'last-processed-order-id' in my memory namespace 'my-secret-namespace-abc123' so we can pick up where we left off.","exampleUseCases":[{"title":"Resume interrupted agent workflow","prompt":"Check my agent memory namespace 'workflow-ns-x7k2' for the key 'last-checkpoint' so we know where the previous run left off and can continue from there."},{"title":"Recall cached API result from earlier run","prompt":"Fetch the value stored under 'weather-cache-2024-06-01' in my namespace 'agent-cache-ns9900' — I want to see if we already fetched that data today before making another paid call."},{"title":"Retrieve user preference saved by agent","prompt":"Pull up what's stored under the key 'user-preferred-language' in my agent namespace 'prefs-namespace-delta44' so I can personalise the response without asking the user again."}],"resultDescription":"Returns a JSON object with the key name, the stored string value, its size in bytes, the ISO timestamp of when it was last updated (updatedAt), and when it will expire (expiresAt). Returns HTTP 404 (not charged) if the key was never written or has already expired.","failureModes":["404 Not Found — key never existed or has expired; not billed","Invalid namespace — must be 16–128 characters using only letters, digits, hyphens, or underscores","Key too long — key exceeds 200 characters","Eventual consistency lag — a value written elsewhere may not be visible for up to 60 seconds","Unauthorized access — namespace is shared with anyone who knows it; treat as a secret"],"whenToPreferThis":"Use this endpoint when an AI agent needs to recall state, checkpoints, preferences, or cached results that were saved in a prior run via /memory/set. It is purpose-built for stateless agent architectures that need lightweight cross-run persistence without a database. Prefer it over general-purpose KV stores when you need pay-per-call simplicity with no account setup, automatic 30-day TTL management, and direct HTTP or MCP access from any agent framework.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T06:53:54.149Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-agent-memory-read-recall-7716537e"}