---
title: "Delete an empty folder"
method: DELETE
path: "/api/folders/{id}"
tags: ["files"]
---

# Delete an empty folder

`DELETE /api/folders/{id}`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/folders/{id}`
- Auth: HTTP bearer

Clerk session or agt_ token with `files:write` (live tier re-checked). Owner or operator only, and the folder must already be EMPTY — deleting a folder never cascades into its files or subfolders.

## Path parameters

- `id` string, required

## Response `200`

Deleted.

- FolderDeleteResponse
  - `ok` boolean, required
  - `id` string, required

## Other responses

- `400`: The folder is not empty.
- `401`: No auth.
- `403`: Not the owner and not an operator.
- `404`: No such folder.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)