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

# upsert_folder_summary

> Create or update a folder summary

> [tab] Sync
>
> ```python theme={null}
> def upsert_folder_summary(
>     folder_id_or_path: str,
>     content: str,
>     versioning: bool = True,
>     overwrite_latest: bool = False,
> ) -> Summary
> ```

> [tab] Async
>
> ```python theme={null}
> async def upsert_folder_summary(
>     folder_id_or_path: str,
>     content: str,
>     versioning: bool = True,
>     overwrite_latest: bool = False,
> ) -> Summary
> ```

## Parameters

* `folder_id_or_path` (str): Folder identifier (UUID, name, or canonical path)
* `content` (str): Summary content (markdown or plain text)
* `versioning` (bool, optional): Create a new version instead of overwriting. Defaults to True.
* `overwrite_latest` (bool, optional): Overwrite the latest summary when versioning is enabled. Defaults to False.

## Returns

* `Summary`: Updated summary payload

## Examples

> [tab] Sync
>
> ```python theme={null}
> from morphik import Morphik
>
> db = Morphik()
> summary = db.upsert_folder_summary(
>     folder_id_or_path="/projects/alpha",
>     content="Summary of project alpha documents.",
> )
> print(summary.version)
> ```

> [tab] Async
>
> ```python theme={null}
> from morphik import AsyncMorphik
>
> async with AsyncMorphik() as db:
>     summary = await db.upsert_folder_summary(
>         folder_id_or_path="/projects/alpha",
>         content="Summary of project alpha documents.",
>     )
>     print(summary.version)
> ```


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