---
title: "Propose Compaction"
method: POST
path: "/memories/compact"
---

# Propose Compaction

`POST /memories/compact`

## Request

- Base URL: `https://cathedral-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://cathedral-ai.com/memories/compact`
- Auth: none declared. Required headers: `authorization`

Propose merges for low-importance memories.
Groups memories by category, returns clusters of similar-importance memories
that could be combined. Agent reviews and confirms via POST /memories/compact/confirm.
Does NOT modify anything — purely advisory.

## Query parameters

- `max_importance` number
- `category` string, nullable
- `limit` integer

## Headers

- `authorization` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cathedral-ai/apis/cathedral-memory-service.md) · [All operations](https://skmtc.dev/cathedral-ai/apis/cathedral-memory-service/llms.txt) · [OpenAPI document](https://skmtc.dev/cathedral-ai/apis/cathedral-memory-service/revisions/e40fefc11dcf?raw)