delete_folder.mdx

title	delete_folder
description	Delete a folder and its documents

```python def delete_folder( folder_id_or_name: str, ) -> Dict[str, Any] ``` ```python async def delete_folder( folder_id_or_name: str, ) -> Dict[str, Any] ```

Parameters

• folder_id_or_name (str): Folder identifier. Accepts the folder's UUID, name, or canonical path (e.g., /projects/alpha/specs; leading slash optional).

Returns

• Dict[str, Any]: Dictionary containing status and message describing the deletion.

Examples

```python from morphik import Morphik

db = Morphik()
db.delete_folder("marketing_docs")
db.delete_folder("/projects/alpha/specs")
db.delete_folder("bfd74128-8539-4050-8938-542d6ee68be0")
```

```python from morphik import AsyncMorphik

async with AsyncMorphik() as db:
    await db.delete_folder("marketing_docs")
    await db.delete_folder("/projects/alpha/specs")
    await db.delete_folder("bfd74128-8539-4050-8938-542d6ee68be0")
```