# Expand Summary Memory into Original Consolidated Memories

> Expand Summary Memory into Original Consolidated Memories is a free API for AI agents from memory.withzero.xyz, Free, status unknown (last checked 2026-09-15).

Expands a recalled summary memory node into the original individual memories it was consolidated from, optionally ranked by relevance to a query.

## Facts

- Endpoint: POST https://memory.withzero.xyz/api/v1/contexts/expand
- Price: Free
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 3
- Provider: memory.withzero.xyz
- Website: https://memory.withzero.xyz
- Canonical page: https://www.zero.xyz/c/memory-withzero-xyz-expand-summary-memory-into-original-consolidated-f6e71080
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VPfcYCn89JID6grk3pDBb

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 memory-withzero-xyz-expand-summary-memory-into-original-consolidated-f6e71080 -d '<json body>'
```

Example prompt: Expand the summary memory with ID 3f2a1b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c into its original memories — rank them by relevance to 'project planning decisions' and return the top 10.

## When to prefer this

Use this endpoint when you have already recalled a summary memory (is_summary=true) and need to drill down into the original granular memories it represents. This is the correct endpoint for decomposing consolidated/dreamed memory clusters into their source records. Prefer this over raw recall when you already have a summary_id and want the underlying detail, or when you want to rank child memories by relevance to a specific follow-up query.

## Known failure modes

- summary_id not found or does not belong to the authenticated agent — 404 or empty memories array
- summary_id references a non-summary memory (is_summary=false) — may return empty or error
- invalid UUID format for summary_id — 400 validation error
- limit out of range (< 1 or > 200) — 400 validation error
- query exceeds 4096 characters — 400 validation error
- cluster has no children (empty consolidation) — returns empty memories array

## How this service works

Expand a recalled summary into the original memories it consolidated (free).

## Output

Returns an array of memory objects, each with id, ns (namespace), key, and content fields. When a query is provided, each result also includes a cosine distance score indicating relevance (lower = more relevant). Results are ordered by relevance to the query, or chronologically if no query is given.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "summary_id"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 200,
   "minimum": 1,
   "description": "Max child memories to return (default 10 when `query` is set, else 200)."
  },
  "query": {
   "type": "string",
   "maxLength": 4096,
   "minLength": 1,
   "description": "Optional: rank the children by relevance to this query and return the top `limit` (default 10). Omit to return the whole cluster in chronological order (default 200)."
  },
  "summary_id": {
   "type": "string",
   "format": "uuid",
   "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
   "description": "The id of a summary memory (is_summary=true, as returned by recall) to expand into the original memories it consolidated."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "memories"
 ],
 "properties": {
  "memories": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "ns",
     "key",
     "content"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "ns": {
      "type": "string"
     },
     "key": {
      "type": "string"
     },
     "content": {
      "type": "string"
     },
     "distance": {
      "type": "number",
      "description": "Cosine distance to `query` (smaller = more relevant). Present only when `query` was given."
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/memory-withzero-xyz-expand-summary-memory-into-original-consolidated-f6e71080/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.withzero.xyz](https://www.zero.xyz/host/memory.withzero.xyz/llms.txt)