{"uid":"cap_Pnqeh-bZavB2dzpVis4lL","slug":"agent-memory-api-recall-6018da0e","name":"Agent Memory API - Recall","description":"Pay-per-request encrypted memory APIs for autonomous AI agents using x402. Store, recall, and audit AI agent memory with AES-256 encryption. Built for USDC/Base payments and Japanese AI agent workflows.","url":"https://agent-memory-api-bix5.onrender.com/api/memory/recall","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query","agent_id"],"properties":{"tags":{"type":"string"},"limit":{"type":"string"},"query":{"type":"string"},"agent_id":{"type":"string"}}},"responseSchema":{"type":"object","title":"RecallMemoryResponse","required":["memories","next_recommended"],"properties":{"memories":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Memories"},"next_recommended":{"type":"object","title":"NextRecommendation","required":["api_name","url","reason","expected_improvement","price_usdc"],"properties":{"url":{"type":"string","title":"Url"},"reason":{"type":"string","title":"Reason"},"api_name":{"type":"string","title":"Api Name"},"price_usdc":{"type":"number","title":"Price Usdc"},"expected_improvement":{"type":"string","title":"Expected Improvement"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rqBF7LhsibuqGKfEPa5Ay","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves encrypted stored memories for an AI agent by semantic query and agent ID, returning matching memory records and a next recommended API action.","exampleAgentPrompt":"Search the encrypted memory for agent 'agent-42' and recall anything it knows about 'user onboarding preferences', returning up to 5 results.","exampleUseCases":null,"resultDescription":"Returns an array of matching encrypted memory objects associated with the agent, plus a next_recommended object suggesting the most relevant follow-up API to call (with its name, URL, reason, expected improvement, and price in USDC).","failureModes":["Missing required fields (agent_id or query) returns a 422 validation error","No matching memories found returns an empty memories array","Invalid agent_id returns empty or unauthorized response","Service unavailable on Render free tier due to cold start or sleep — slow or timeout response","Payment not processed via x402 results in 402 Payment Required before memory is returned"],"whenToPreferThis":"Use this endpoint when an autonomous AI agent needs to recall previously stored context, facts, or interaction history by semantic query. Prefer this over generic vector DBs when you need AES-256 encrypted per-agent memory with built-in x402/USDC micropayment gating and an agentic next-step recommendation in the response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:37:37.377Z","isFirstParty":false}