upsert_summary

Create or update a folder summary

This method is available on Folder objects.

Sync

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

Async

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

Parameters

• 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

from morphik import Morphik

db = Morphik()
folder = db.get_folder("/projects/alpha")
summary = folder.upsert_summary("Summary of project alpha.")
print(summary.version)

Async

from morphik import AsyncMorphik

async with AsyncMorphik() as db:
    folder = await db.get_folder("/projects/alpha")
    summary = await folder.upsert_summary("Summary of project alpha.")
    print(summary.version)