---
title: "Folder Maintenance"
method: GET
path: "/v1/folders/maintenance"
tags: ["folders"]
---

# Folder Maintenance

`GET /v1/folders/maintenance`

## 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/folders/maintenance`
- Auth: HTTP bearer

## Response `200`

Successful Response

- FolderMaintenanceProposal: ``GET /v1/folders/maintenance`` response (§14). Proposals only — no mutation. Count-based MVP; full §14.2 similarity-merge / §14.3 cluster-split is deferred (DECISIONS 2026-06-02).
  - `merge_candidates` FolderMergeCandidate[]
    - `folder` string, required
    - `parent` string, required
    - `count` integer, required
    - `sibling_folders` string[]
    - `reason` string, required
  - `split_candidates` FolderSplitCandidate[]
    - `folder` string, required
    - `count` integer, required
    - `reason` string, required
  - `summary` FolderMaintenanceSummary, required
    - `total_folders` integer, required
    - `merge_candidates` integer, required
    - `split_candidates` 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)