---
title: "Memory map summary"
method: GET
path: "/spaces/{space_id}/memory-map/summary"
tags: ["spaces"]
---

# Memory map summary

`GET /spaces/{space_id}/memory-map/summary`

Lightweight counts and tag histogram for the Memory Workspace map. Does not return memory body text. When the space exceeds the scan cap, `meta.approximate_counts` is true and totals may be lower bounds. `top_tags` are derived from the first `meta.tag_sample_limit` objects (newest first) matching filters.

## Path parameters

- `space_id` string, required

## Query parameters

- `exclude_chunks` boolean — When true, exclude chunk rows; map shows logical memories
- `tags` string[], nullable — Filter by tags (any match)
- `source` string, nullable — Filter by source
- `min_importance` integer, nullable — Minimum importance
- `tag_sample_limit` integer — Max objects scanned for top_tags histogram

## Response `200`

Successful Response

- MemoryMapSummary — Lightweight space-level stats for the Memory Map UI. Tag histograms are computed from the first ``tag_sample_limit`` objects matching filters and sort (newest first), not necessarily the full space.
  - `space_id` string, required — Space identifier
  - `total_nodes` integer, required — Count of objects matching filters (and exclude_chunks when true)
  - `total_raw_objects` integer, nullable — When exclude_chunks is true, total objects before excluding chunks
  - `top_tags` MemoryMapTagCount[] — Most frequent tags in the sampled set (see meta.tag_sample_limit)
    - `tag` string, required — Lowercased tag name
    - `count` integer, required — Occurrences in the sampled set
  - `chunks_excluded_count` integer, nullable — When exclude_chunks is true, number of chunk rows not shown as nodes
  - `meta` MemoryMapSummaryMeta, required — Metadata about how the memory map summary was computed.
    - `computed_at` string, date-time, required — Server time when the summary was built
    - `sort_basis` string — Sort order used when sampling objects for tag histograms
    - `tag_sample_limit` integer, required — Max number of objects scanned for top_tags (histogram may omit rare tags)
    - `approximate_counts` boolean — True if total_nodes hit the count scan cap and may be a lower bound

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/memara/apis/memara-api.md) · [All operations](https://skmtc.net/memara/apis/memara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memara/memara-api/versions/4dc7c4418845/schema)