{"uid":"cap_gA-ZltcbnR07Hh1fzbJh1","slug":"squeezeos-agent-memory-recall-api-4ec05194","name":"SqueezeOS Agent Memory Recall API","description":"Agent memory recall API — literal keyword and tag search over one agent's stored provenance-tracked memories.","url":"https://squeezeos-api.onrender.com/api/memory/recall","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":["agent_id"],"properties":{"tags":{"type":"string","description":"Optional comma-separated tags Search intents: agent memory api, memory recall api, persistent agent memory, agent knowledge store."},"limit":{"type":"string","description":"Maximum results Search intents: agent memory api, memory recall api, persistent agent memory, agent knowledge store."},"query":{"type":"string","description":"Literal keyword query Search intents: agent memory api, memory recall api, persistent agent memory, agent knowledge store."},"agent_id":{"type":"string","description":"Agent memory namespace Search intents: agent memory api, memory recall api, persistent agent memory, agent knowledge store."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}},"additionalProperties":false}},"additionalProperties":false},"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_cs8X6soXFgtiYVNWVyEE1","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":"Performs literal keyword and tag-based search over a specific agent's stored, provenance-tracked memories within its namespace.","exampleAgentPrompt":"Search agent 'agent-42's memory store for any memories tagged 'market-intel' that mention the keyword 'GME', and return up to 10 results.","exampleUseCases":[{"title":"Recall previous research context","prompt":"Look through agent 'research-bot-7's stored memories for anything mentioning 'short interest' — show me up to 5 results so I can pick up where it left off."},{"title":"Filter memories by topic tag","prompt":"Find all memories stored for agent 'trading-agent-1' that are tagged 'earnings' — I need to see what context it has on that topic."},{"title":"Debug agent decision history","prompt":"Search agent 'orchestrator-99's memory namespace for any records containing the keyword 'halt' so I can figure out why it stopped a workflow last week."}],"resultDescription":"Returns a JSON object containing matched memory records from the specified agent's namespace, including provenance-tracked content and any associated metadata such as tags and timestamps, filtered by the provided keyword query and/or tags up to the specified result limit.","failureModes":["Missing required agent_id parameter returns an error or empty response","No memories matching the query or tags returns an empty result set","Invalid agent_id namespace (non-existent agent) returns empty or error","Service unavailable on Render cold-start (free-tier spin-up delay)","Payment not processed (x402) results in 402 response before query executes"],"whenToPreferThis":"Choose this endpoint when you need to retrieve previously stored memories for a specific agent by exact keyword or tag match, particularly when provenance tracking is important. Prefer this over vector/semantic search endpoints when exact keyword recall is needed rather than fuzzy similarity. Suitable for agents that need to resume prior context, audit decision history, or filter knowledge by categorical tags.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:44:42.681Z","isFirstParty":false}