clear_file_share_settings
ChatGPTTurn off link sharing for a file. A subsequent get_file_share_settings call returns enabled=false. Idempotent — clearing a file that already has no link sharing succeeds. Requires MANAGE on the file.
continue_design
ChatGPTQueue another user turn on an existing chat, letting the caller iterate on the deliverable — refine the copy, swap a colour, edit a page — without spawning a new file. Reuses the chat's history and file. Returns immediately with the new submission id; poll get_design_task with the same chatId to see the result. If a previous turn on this chat is still running, this errors — poll get_design_task first and retry once its status leaves running.
create_design
ChatGPTCreate an editable design file — slides, posters, social graphics, one-page layouts — from a written brief. Playyy's design agent lays the pages out in the editor; the result is a file the user can open, edit, and export, not a rendered image. Returns immediately with a chatId and fileId. Use get_design_task to poll for completion and get the editor link with a first-page preview. Pass fileId to work inside an existing file the caller already has; otherwise a new file is created.
create_document
ChatGPTCreate a DOC page. Append it to an existing file, or create a new file holding the document alone when fileId is omitted. The document starts with one empty level-1 heading. Returns the document id (also the id of the root page block) and the file it lives in.
create_file
ChatGPTCreate an empty file — a container with no pages yet. Pass the returned fileId to create_document to add a document page, or to create_design to run an agent task inside it. Either tool without a fileId is the shortcut when the container is not needed up front.
delete_document
ChatGPTDelete a document. Deleting the last page of a file deletes the file too.
delete_file
ChatGPTDelete a file and every page in it. Permanent — there is no trash and nothing can be restored — so confirm with the user before calling it on a file they did not just create. Takes any published page down with it. Requires MANAGE on the file.
edit_doc_page
ChatGPTApply a batch of block edits to a DOC page as one atomic delta — a batch that produces a delta advances the page revision by one; a batch that produces no delta returns the current revision without advancing it; failure leaves the page untouched. ops runs in order; every op addresses its target by id, so a retry after a lost response lands on the same block whether or not neighbours shifted. insert_before / insert_after place siblings around a refId; insert_as_child places children under a parentId at first or last position; update and delete name the block by id. idempotencyKey is required: a fresh UUID per new edit, the same one on every retry of that edit — keys are scoped to (workspace, PAT owner, page).
export_design
ChatGPTExport a design file to PNG, JPG, PPTX, or XLSX. Polls until the export completes and returns a signed download URL. For PNG/JPG, a single page returns the image directly; multiple pages return a ZIP archive.
get_design_task
ChatGPTCheck the status of a design task created by create_design. When the task is completed, automatically exports a preview image of the first page and returns it together with the editor link. Call this repeatedly until status is 'completed' or 'failed'.
get_document
ChatGPTFetch a document's title and current revision.
get_file_share_settings
ChatGPTRead the current link-sharing configuration for a file. When link sharing is off, returns enabled=false — the file is then reachable only through explicit collaborator grants. Requires MANAGE on the file.
list_doc_blocks
ChatGPTReturn every block in the document — the root page block first, the rest depth-first in document order. Each item carries its blockId, parentId, blockType, children (for container blocks), and the payload keyed by block type.
list_file_pages
ChatGPTList a file's title and every page in it, in file order. A page's pageId is the id its content tools take — a DOC page's pageId is its documentId.
list_files
ChatGPTList the caller's own files and the files shared with them directly, most recently updated first. A file reachable only through a workspace-wide sharing link is not listed. Use it to find a file the user refers to by name before calling list_file_pages, export_design or continue_design on it. title narrows the list to titles containing the text (case-insensitive). Each item carries pageCount and, once rendered, a short-lived coverUrl thumbnail of the first page. total counts every match, so page through with page when it exceeds the page size.
list_members
ChatGPTList members of the workspace the caller belongs to. Use this to resolve a userId for the mentionUserId field of a text run inside an edit_doc_page op. email narrows the result to the one member holding that exact address (case-insensitive); omit it to list every member. An empty result does not mean the address has no Playyy account — only that no one in this workspace holds it.
rename_document
ChatGPTRename a document. The title is page metadata; editing it does not change the document body.
set_file_share_settings
ChatGPTTurn on link sharing for a file, or update its current mode and permission. Both accessMode and permission are required — the server never picks a default, so the caller must state the intent. accessMode is restricted to WORKSPACE_MEMBERS here; opening a file to the whole internet via this tool is not supported. Requires MANAGE on the file. Prefer inviting specific collaborators (via create_design's collaboratorEmail or the platform grants API) when only one person needs access — link sharing hands the same permission to every workspace member.
upload_attachment
ChatGPTFetch a file from a public URL and stage it as an attachment the agent can use as reference material — a logo to place, a brief to follow, a photo to feature, a spreadsheet to chart. Pass the returned attachmentId in attachmentIds of create_design or continue_design within 24 hours; an attachment is tied to the task that first uses it. The URL must be reachable without credentials and serve at most 10 MiB of avif, csv, docx, gif, jpeg, jpg, md, mp3, mp4, pdf, png, pptx, svg, txt, webp, xlsx, or zip.