> ## Documentation Index
> Fetch the complete documentation index at: https://morphik.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# delete_folder

> Delete a folder and its documents

> [tab] Sync
>
> ```python theme={null}
> def delete_folder(
>     folder_id_or_name: str,
> ) -> Dict[str, Any]
> ```

> [tab] Async
>
> ```python theme={null}
> 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

> [tab] Sync
>
> ```python theme={null}
> 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")
> ```

> [tab] Async
>
> ```python theme={null}
> 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")
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.