# SqueezeOS Agent Memory Recall API

> SqueezeOS Agent Memory Recall API is a paid API for AI agents from squeezeos-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Performs literal keyword and tag-based search over a specific agent's stored, provenance-tracked memories within its namespace.

## Facts

- Endpoint: GET https://squeezeos-api.onrender.com/api/memory/recall
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/squeezeos-agent-memory-recall-api-4ec05194
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gA-ZltcbnR07Hh1fzbJh1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability squeezeos-agent-memory-recall-api-4ec05194
```

Example prompt: Search agent 'agent-42's memory store for any memories tagged 'market-intel' that mention the keyword 'GME', and return up to 10 results.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Agent memory recall API — literal keyword and tag search over one agent's stored provenance-tracked memories.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/squeezeos-agent-memory-recall-api-4ec05194/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from squeezeos-api.onrender.com](https://www.zero.xyz/host/squeezeos-api.onrender.com/llms.txt)