---
title: "Delete Folder"
method: DELETE
path: "/agents/folders/{id}"
tags: ["Folders"]
---

# Delete Folder

`DELETE /agents/folders/{id}`

Delete a [knowledge base](/line/knowledge-base) folder

## Path parameters

- `id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `204`

Folder deleted.

## Other responses

- `400` — The folder has child folders that must be deleted or moved first (`error_code: kb_folder_has_children`), or this is the last remaining folder in the organization (`error_code: kb_folder_last`).
- `404` — Folder not found (`error_code: kb_folder_not_found`).

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/versions/8910812440d3/schema)