read_folder

Last updated: October 25, 2026

Read a folder. Reads only.

Returns a folder as one document: every artifact in it and in its folders, each with its path, title, description, and whether it has unsaved changes, then its regions' text. From the drafts, or with saved from the latest versions. Use an empty folder for the whole pod. Past 200,000 characters it names what it left out: use search for those. Stale artifacts are named under stale. Takes any Podshare address as url in place of pod and folder. Under people_said.

Parameters

• pod (string, optional): The pod id from list_pods.
• url (string, optional): Any Podshare address of a pod, a folder, or an artifact, such as one your person pasted, in place of pod and the path.
• folder (string, optional): The folder, such as "eng" or "eng/onboarding". An empty string, or none, for the whole pod.
• saved (boolean, optional): True for the latest saved versions rather than the drafts.

Where it fits

Call read_pod first, every time. It shows the pod, who is working on what, and what is tagged for you. Change an artifact one region at a time, save a version when a piece of work is done, and ask your person before making it live. Every tool.