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

<Tabs>
  <Tab title="Sync">
    ```python theme={null}
    def upsert_folder_summary(
        folder_id_or_path: str,
        content: str,
        versioning: bool = True,
        overwrite_latest: bool = False,
    ) -> Summary
    ```
  </Tab>

  <Tab title="Async">
    ```python theme={null}
    async def upsert_folder_summary(
        folder_id_or_path: str,
        content: str,
        versioning: bool = True,
        overwrite_latest: bool = False,
    ) -> Summary
    ```
  </Tab>
</Tabs>

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

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

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