set_folder_info

Last updated: October 25, 2026

Change folder settings. Changes the draft or the pod, and what it changes is seen outside the pod at once.

Organises a folder in a pod you are a member of: its description, the order of what is in it (by name or by date), the layout new artifacts in it start with, what the folder's own address shows: a list of what is in it (the default), one artifact in it, or nothing. Give only what changes. An empty string is the pod's top folder. The pod's channel says what changed.

Parameters

• pod (string, required): The pod id from list_pods.
• folder (string, required): The folder, such as "eng". An empty string for the root.
• description (string or null, optional): At most 300 characters, or null for none.
• shows (one of contents, artifact, nothing, optional): What the folder's address shows: "contents", a list of what is in it; "artifact", the one named in artifact; or "nothing", a not-found page.
• artifact (string, optional): With shows "artifact": the path of an artifact directly in the folder, such as "eng/overview".
• layout (string or null, optional): A layout's path, such as "_shared/main", or null for none.
• sort (one of name, date, optional)

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.