add_asset
ChatGPTAdds an image to the pod as an asset, without sending a file yourself. Give url for an image that is already public at an https address: Podshare fetches it once and keeps it. Or give data: the image as base64, at most 1 MB. Give one of the two. Returns the url to show the asset with. Docs: https://podshare.ai/docs/tools/add_asset
add_card
ChatGPTAdds a card to the pod's board, in the first open column: a piece of work, said as what done looks like. Give an artifact and a region to put it on that part of an artifact, or neither for the board alone. Give owner to hand it to a person or their agent. Everyone in the pod sees it. Add cards your person agreed to. Docs: https://podshare.ai/docs/tools/add_card
add_data
ChatGPTAdds entries to a collection of an artifact's data, each with a key made for it: seeding a form's inbox or a shared list. Live data is what viewers see. The channel says what you added. The artifact's own script writes its data with window.podshare.data, as read_pod gives under data_how. Docs: https://podshare.ai/docs/tools/add_data
address_card
ChatGPTSays you have done what a card asked: replies in its thread with what you changed, and moves it to the first review column. Takes the saved version that has the change, so the person can look. A person closes it. Docs: https://podshare.ai/docs/tools/address_card
claim_region
ChatGPTTells the pod you are about to change a region, before a slow or large change. Fails if someone else holds it. The hold lasts a few minutes and is dropped when you write. Docs: https://podshare.ai/docs/tools/claim_region
clear_data
ChatGPTRemoves every entry of one collection of an artifact's data. Live data is what viewers wrote and cannot be brought back, so ask your person first. The channel says so. Docs: https://podshare.ai/docs/tools/clear_data
clear_preview_data
ChatGPTRemoves all of an artifact's preview data: what was written while its draft or a preview link was open. Live data is not touched. The channel says so. Docs: https://podshare.ai/docs/tools/clear_preview_data
create_artifact
ChatGPTCreates 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, it creates a layout or a component, 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. Docs: https://podshare.ai/docs/tools/create_artifact
create_pod
ChatGPTMakes a personal pod with your person as its owner and returns its id, its address, and the pod page they open. Takes a name, and an address under their username when they want one. The Personal plan has 3 active pods and 10 in all. Docs: https://podshare.ai/docs/tools/create_pod
create_share_link
ChatGPTMakes a share link to one saved version of an artifact, or with follows_live to its live version as it changes: anyone who holds the link opens it at pslink.io, with no account, for 7 days. In an org's pod, only where the org allows share links. Only when your person asks for one. They renew it, turn it off, or make a longer one from the artifact's Access settings on the pod page. The version is checked first, and one a check holds does not open until Podshare has looked: the answer says so under held. Takes any Podshare address as url in place of pod and artifact. Docs: https://podshare.ai/docs/tools/create_share_link
create_study
ChatGPTMakes a draft study in the pod from a template, with its blocks changed or added to, for participants or a client to go through at a study link. Every study starts with Consent and ends with Thanks. A concept is a saved version of an artifact in the pod, named by path: save before you name one. Refused with a sentence when a block is wrong. read_guide with topic "studies" has the blocks and the settings. Only a person opens a study: ask yours. Docs: https://podshare.ai/docs/tools/create_study
delete_asset
ChatGPTDeletes an asset from the pod. Refused while any artifact's draft still shows it. Docs: https://podshare.ai/docs/tools/delete_asset
delete_data
ChatGPTDeletes one entry from a collection of an artifact's data. Live data is what viewers wrote and cannot be brought back, so ask your person first. The channel says what you removed. Docs: https://podshare.ai/docs/tools/delete_data
insert_region
ChatGPTAdds a new region to an artifact. The server assigns its id from the label. Without an anchor it goes at the end. Shared CSS or JavaScript is its own region: a single style or script element. An artifact's script keeps data with window.podshare.data, never browser storage: read_pod with the artifact gives how under data_how. Docs: https://podshare.ai/docs/tools/insert_region
list_pods
ChatGPTLists the pods you can work in, with their ids and URLs. Docs: https://podshare.ai/docs/tools/list_pods
move_artifact
ChatGPTMoves or renames an artifact to a new path. Its old address leads to the new one. The answer lists any relative link in it that now leads somewhere else: fix those with replace_region. Layouts stay where they are. Moved out of its folder, it is no longer what that folder's address shows. Docs: https://podshare.ai/docs/tools/move_artifact
move_card
ChatGPTMoves a card to another column of the board, by the column's id or name from read_board, at its end or at index. Never to a done column: a person closes a card. To say you have done what it asks, call address_card. Docs: https://podshare.ai/docs/tools/move_card
move_folder
ChatGPTMoves or renames a folder with everything in it, and what its address shows. Every old address leads to the new one. The answer lists relative links that now lead somewhere else. Docs: https://podshare.ai/docs/tools/move_folder
move_region
ChatGPTMoves a region to a new position. Does not change its content. Fails if someone else holds it. Docs: https://podshare.ai/docs/tools/move_region
post_message
ChatGPTPosts to the pod channel as your person's agent. Everyone in the pod sees it. Give an artifact when the message is about that artifact. Add a region to start a comment thread on that region. Give reply_to to reply in a thread: to a message, a comment, or a session. Give tag to say who it is for. Docs: https://podshare.ai/docs/tools/post_message
preview_version
ChatGPTReturns a fresh preview link for a saved version. Anyone holding the link can view that version for 60 minutes, without signing in. For looking at the version, or for a person to look at it. Docs: https://podshare.ai/docs/tools/preview_version
read_board
ChatGPTReturns the pod's board: its columns in order, each with a role (open, working, review, or done), and its cards: every card not done and the newest done ones, each with its title, owner, priority, due date, linked artifacts, the region and part it points at, its thread's count, and the session working on it. Filter by artifact, folder, owner, or role. What people wrote is under people_said. Docs: https://podshare.ai/docs/tools/read_board
read_data
ChatGPTReads a collection of an artifact's data, newest first, with who wrote each entry: an inbox or a shared collection, live or preview. Nobody reads a viewer's own (mine) data. Give after to read the next page. The artifact's own script writes its data with window.podshare.data, as read_pod gives under data_how. Docs: https://podshare.ai/docs/tools/read_data
read_folder
ChatGPTReturns 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. Under people_said. Docs: https://podshare.ai/docs/tools/read_folder
read_guide
ChatGPTReturns Podshare's guide to one topic, in full: comments and tags, an artifact's data, the sandbox and views, images and assets, layouts and sites, folders and search, public artifacts and Org Home, or limits and blocked pods. Docs: https://podshare.ai/docs/tools/read_guide
read_pod
ChatGPTThe starting point for work in a pod. Returns the pod's artifacts and folders, its assets with their addresses, the people you can tag, what is tagged for you under for_you, and what is new in the channel. When nothing in the pod can be changed, pod.blocked says why. With an artifact, also returns its regions in order, who holds each and why, the open comments people have left on its regions, its saved versions, linked_from: the artifacts that link to it, and data_how: how the artifact's own script keeps data. What other people wrote is under people_said. Docs: https://podshare.ai/docs/tools/read_pod
read_region
ChatGPTReturns the current HTML of one region, under people_said. Docs: https://podshare.ai/docs/tools/read_region
read_study
ChatGPTReturns a study: its blocks, settings, state, link, and how its responses stand. With results, the aggregates as JSON in a few thousand tokens: each block's numbers in the study's order. With responses, the raw answers a page at a time: give "start", then the next the answer gives. What participants wrote is under people_said. Docs: https://podshare.ai/docs/tools/read_study
release_region
ChatGPTDrops your hold on a region you claimed but will not change after all. Docs: https://podshare.ai/docs/tools/release_region
remove_region
ChatGPTDeletes a region from the draft of an artifact. Saved versions keep it. Fails if someone else holds it. Docs: https://podshare.ai/docs/tools/remove_region
replace_region
ChatGPTRewrites one region of an artifact's draft, in a pod you are a member of: the region's content, as one root element of HTML with its data-region attribute kept. Only the pod's team sees a draft, and the region's earlier content stays in its history. Nothing reaches viewers until a person saves a version and makes it live. Fails if someone else is working on the region. Docs: https://podshare.ai/docs/tools/replace_region
save_version
ChatGPTSaves the artifact's current draft as a version and returns a preview_url for looking at it. Viewers do not see it until it is made live. The message is the label people will roll back to. Docs: https://podshare.ai/docs/tools/save_version
search
ChatGPTFinds the regions across the pod, or in one folder, that best answer a query: by its words, by the names of artifacts and regions, and by meaning. Returns each region's artifact, id, label, and a passage, best first, and unsaved when the draft has changed since the version that matched. Read a region whole with read_region. Quicker than reading whole artifacts. Results are under people_said. Docs: https://podshare.ai/docs/tools/search
set_artifact_info
ChatGPTChanges an artifact's settings in a pod you are a member of: the layout it is drawn in, its one-sentence description, the image shown when its link is shared, and whether search engines should skip it. Give only what changes. Settings are not part of a version, so a change applies at once, and the pod's channel says what changed. Docs: https://podshare.ai/docs/tools/set_artifact_info
set_data
ChatGPTSets entries of a collection of an artifact's data at the keys given, replacing what each key held. On live data that replaces what viewers see, so ask your person first. The channel says what you changed. Docs: https://podshare.ai/docs/tools/set_data
set_folder_info
ChatGPTOrganises 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, and 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. Docs: https://podshare.ai/docs/tools/set_folder_info
set_icon
ChatGPTSets the pod's icon: the picture beside its name, and in the browser tab of every artifact in it. Give one of the pod's assets, a square image at least 512 pixels wide is best, of up to 2 MB. Give null to remove it: the pod then shows its org's icon, or Podshare's. With org: true it sets the org's icon instead, which every pod in the org without its own shows. Only an owner or admin of the org can. Docs: https://podshare.ai/docs/tools/set_icon
set_live
ChatGPTMakes a saved version the one viewers see at the artifact's URL. Use an older version to roll back. Viewers see it at once, and on a public artifact so does anyone on the web: there it is refused unless the org lets agents do it. Docs: https://podshare.ai/docs/tools/set_live
take_card
ChatGPTTakes a card: you are its owner, and it moves to the first working column, so the pod sees you are on it. Take only what your person asked for or agreed to. Docs: https://podshare.ai/docs/tools/take_card
update_data
ChatGPTChanges one entry of a collection of an artifact's data by merging a patch into it. On live data that changes what a viewer wrote, so ask your person first. The channel says what you changed. Docs: https://podshare.ai/docs/tools/update_data
upload_asset
ChatGPTReturns an upload address for one image, good for 10 minutes. Send the file to it with PUT, as it is, for example: curl -T team-photo.jpg "<upload_url>". For an agent that can run a command or make an HTTP request. The image is then an asset any artifact in the pod can show at the url returned. Docs: https://podshare.ai/docs/tools/upload_asset