{"uid":"cap_VPfcYCn89JID6grk3pDBb","slug":"memory-withzero-xyz-expand-summary-memory-into-original-consolidated-f6e71080","name":"Expand Summary Memory into Original Consolidated Memories","description":"Expand a recalled summary into the original memories it consolidated (free).","url":"https://memory.withzero.xyz/api/v1/contexts/expand","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"memory.withzero.xyz","brandSlug":"memory-withzero-xyz-mpp","brandBaseUrl":"https://memory.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Expands a recalled summary memory node into the original individual memories it was consolidated from, optionally ranked by relevance to a query.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Drill into a recalled summary","prompt":"I just recalled a summary memory with ID a1b2c3d4-e5f6-7890-abcd-ef1234567890 — can you expand it into the original individual memories it was consolidated from? Just return them in chronological order for now."},{"title":"Rank memories by topic relevance","prompt":"I have a summary node with ID 9f8e7d6c-5b4a-3210-fedc-ba9876543210 from my research sessions. Expand it into its source memories and rank them by relevance to 'customer pain points' so I can find the most pertinent details quickly."},{"title":"Unfold compressed memory cluster","prompt":"We dreamed a memory cluster last night with summary ID 2c3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f — unfold it back into all the original memories it was built from so I can review what went into that consolidation."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:25.283Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:15.272Z","isFirstParty":true}