> ## 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

<Tabs>
  <Tab title="Sync">
    ```python theme={null}
    def delete_folder(
        folder_id_or_name: str,
    ) -> Dict[str, Any]
    ```
  </Tab>

  <Tab title="Async">
    ```python theme={null}
    async def delete_folder(
        folder_id_or_name: str,
    ) -> Dict[str, Any]
    ```
  </Tab>
</Tabs>

## 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

<Tabs>
  <Tab title="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>

  <Tab title="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")
    ```
  </Tab>
</Tabs>