---
title: "Trash a folder"
method: POST
path: "/api/notebooks/{notebook}/folders/{folder}/trash"
tags: ["notebook-folder-controller"]
---

# Trash a folder

`POST /api/notebooks/{notebook}/folders/{folder}/trash`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/notebooks/{notebook}/folders/{folder}/trash`
- Auth: none declared

Moves an active folder subtree beneath _trash while mirroring its original ancestor path. The subtree and authored content are retained for ordinary Move recovery.

## Path parameters

- `notebook` integer, required
- `folder` integer, required

## Response `200`

OK

- Folder
  - `id` integer, required
  - `readmeContent` string
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `parentFolderId` integer: Parent folder id when nested; omitted at notebook root.
  - `name` string, required

## Changes

- **2026-09-19** `b88bb26a237e`: 2 info
  - api tag `notebook-folder-controller` added
  - api tag `notebook-controller` removed
- **2026-09-14** `68bc3a0e7450`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/changes/api/notebooks/:notebook/folders/:folder/trash/post.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api.md) - [All operations](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/revisions/193c5e89085a?raw)