---
title: "Organize Memories"
method: POST
path: "/v1/memories/organize"
tags: ["memories"]
---

# Organize Memories

`POST /v1/memories/organize`

## Request

- Base URL: `https://api.heirmos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heirmos.com/v1/memories/organize`
- Auth: HTTP bearer

Propose-only cleanup analysis for the dashboard "정리" button (#2).

Returns near-duplicate clusters, conflicting/needs-review memories, and
low-value stale candidates. **Never mutates** — the user confirms each
action client-side; applying reuses POST /consolidate + DELETE /{path}
(Heirmos principle: AI proposes, user owns).

## Response `200`

Successful Response

- OrganizeProposal
  - `duplicate_clusters` DuplicateCluster[], required
    - `paths` string[], required
    - `titles` string[], required
    - `similarity` number, required
  - `conflicts` ConflictItem[], required
    - `id` string, required
    - `path` string, required
    - `title` string, required
    - `content` string, required
    - `status` string, required
    - `reason` string, required
    - `confidence` number, nullable
    - `ai_reasoning_summary` string, nullable
  - `stale` StaleItem[], required
    - `path` string, required
    - `title` string, required
    - `importance` number, required
  - `summary` OrganizeSummary, required
    - `total` integer, required
    - `duplicate_clusters` integer, required
    - `conflicts` integer, required
    - `stale` integer, required

---

[API](https://skmtc.dev/heirmos/apis/heirmos-api.md) · [All operations](https://skmtc.dev/heirmos/apis/heirmos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heirmos/apis/heirmos-api/revisions/ed490b1866e7?raw)