{"uid":"cap_fw5QM4OSoF7QqnhqhVz-M","slug":"agent-memory-api-fetch-memory-by-key-9cdf9757","name":"Agent Memory API – Fetch Memory by Key","description":"Fetch a single stored memory by namespace and key. Returns the memory record as JSON (404 if not found).","url":"https://agent-memory-api-production-f2c4.up.railway.app/v1/memories/bazaar-seed/hello","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qqnorSOIMh4C_qL75oGuF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve a single stored memory record by namespace and key, returning the JSON memory object or 404 if not found.","exampleAgentPrompt":"Can you fetch the memory stored under the key 'hello' in the 'bazaar-seed' namespace so I can see what value was saved there?","exampleUseCases":[{"title":"Restore agent session context","prompt":"Pull up the memory my agent saved under the key 'user-preferences' in the 'session-42' namespace so we can pick up where we left off."},{"title":"Check onboarding state for a user","prompt":"Look up the 'onboarding-complete' key in the 'user-7891' namespace and tell me what's stored there."},{"title":"Retrieve cached agent decision","prompt":"Fetch the memory record stored under key 'last-decision' in the 'workflow-agent' namespace so we know what the agent chose last time."}],"resultDescription":"A JSON object containing the full memory record for the requested namespace and key, including the stored value and any associated metadata such as TTL and timestamps. Returns HTTP 404 if the key does not exist in the given namespace.","failureModes":["404 Not Found – the specified key does not exist in the given namespace","Invalid namespace or key format causing a 400 error","Service unavailable or Railway deployment down (5xx)","Payment failure via x402 preventing the request from being fulfilled","Expired TTL causing the record to no longer be present"],"whenToPreferThis":"Use this endpoint when you need to retrieve a single, specific memory record by its exact namespace and key rather than listing all memories. Prefer this over the list endpoint when you already know the key and want a direct point lookup with minimal overhead. Ideal for agent workflows that previously stored a value and need to recall it in a subsequent step.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:23.760Z","isFirstParty":false}