create_artifact

Last updated: October 25, 2026

Create an artifact. Changes the draft or the pod.

Creates a new, empty artifact in a pod. Its path becomes its URL, and the part before the last slash is its folder. Add content with insert_region. A path cannot be a folder's. With kind "deck" it creates a deck: one artifact whose regions are its slides, each one root element that fits 1920 by 1080, presented full screen from the pod page. With kind "layout" or "component", it creates one at a path under _shared/. An artifact that keeps data, such as a form, writes it with window.podshare.data: read_pod with the artifact gives how under data_how.

Parameters

• pod (string, required): The pod id from list_pods.
• path (string, required): Lowercase words separated by slashes, such as "launch-plan" or "proposals/q4". For a layout or component, "_shared/" and a name, such as "_shared/main".
• title (string, required)
• kind (one of deck, layout, component, optional): "deck" for a deck of slides, or "layout" or "component" for one under _shared/. Leave it out for a page.
• description (string, optional): What it is for, in a sentence: at most 300 characters. People and agents read it without opening the artifact.

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.