upsert_folder_summary - Morphik Documentation

Sync
Async

def upsert_folder_summary(
    folder_id_or_path: str,
    content: str,
    versioning: bool = True,
    overwrite_latest: bool = False,
) -> Summary

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

Sync
Async

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)

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)