---
title: "Restore Folder"
method: POST
path: "/api/v1/folders/{folder_id}/restore"
tags: ["folders"]
---

# Restore Folder

`POST /api/v1/folders/{folder_id}/restore`

Restore the folder, conditions, and dependents named by its receipt.

Every submitted id is validated atomically for writable-project scope,
current parent linkage, and tombstone state. The server cannot verify that
the set is complete: only the caller's receipt records which rows one delete
stamped, and transaction-stable `deleted_at` cannot reconstruct that fact
(spec-lite §2.1). An incomplete receipt therefore produces ADR-0172's
accepted lossy restore. Returns 409 `not_deleted` for an already-live row.

## Path parameters

- `folder_id` string, uuid, required

## Request body

- RestoreFolderRequest
  - `folder_ids` string[], required
  - `condition_ids` string[], required
  - `measurement_ids` string[], required
  - `multiplier_ids` string[], required

## Response `200`

Successful Response

- Folder
  - `id` string, uuid, required
  - `project_id` string, uuid, required
  - `parent_folder_id` string, uuid, nullable, required
  - `name` string, required
  - `sort_order` number, required
  - `created_at` string, date-time, required

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) · [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rudus/rudus-api/revisions/f149124a4d80/schema)