{"uid":"cap_sHp4h4IPjyQWo5U3sCV96","slug":"contextaiagent-xyz-memory-recall-b53c56e4","name":"contextaiagent.xyz Memory Recall","description":"Recall stored memories via semantic search","url":"https://contextaiagent.xyz/api/memory/recall","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","required":["agent","query"],"properties":{"tags":{"type":"string","description":"Comma-separated tags to filter results"},"agent":{"type":"string","description":"Agent identifier"},"limit":{"type":"number","maximum":50,"minimum":1,"description":"Max results to return"},"query":{"type":"string","description":"Search query for semantic recall"}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O5OgOq_TZ7weNbDuqV3XG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve stored agent memories using semantic search against a query string, filtered by agent ID and optional tags","exampleAgentPrompt":"Search my agent's memory for anything related to 'user onboarding preferences' — use agent ID 'agent-42' and return the top 5 most relevant results.","exampleUseCases":[{"title":"Personalized assistant context retrieval","prompt":"Before you respond to this user, search the memory for agent 'assistant-007' about 'user dietary restrictions' and return up to 10 results so I can personalize the answer."},{"title":"Task continuity across sessions","prompt":"I need to pick up where we left off — search agent 'planner-bot' memories for anything about 'Q3 marketing campaign' and give me the top 3 most relevant stored notes."},{"title":"Tag-filtered knowledge lookup","prompt":"Search agent 'research-agent-1' memories for 'climate policy', but only show results tagged 'verified-sources', up to 5 results."}],"resultDescription":"A ranked list of memory records semantically relevant to the query, associated with the specified agent. Each record likely includes the memory content, relevance score, associated tags, and metadata such as timestamp or memory ID.","failureModes":["Missing required 'agent' or 'query' parameters returns a 400 error","No matching memories found returns an empty result set","Limit parameter outside 1-50 range causes validation error","Invalid agent ID returns empty or error response","Semantic search may return loosely related results if query is ambiguous","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Use this endpoint when an AI agent needs to surface previously stored contextual memories using natural-language semantic similarity rather than exact key-value lookup. It is ideal for agents that persist knowledge across sessions and need to retrieve relevant past context to inform current responses. Prefer this over a direct database query when the retrieval intent is fuzzy or concept-based rather than ID-based.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:48.239Z","isFirstParty":false}