add_branded_slide
ChatGPTUse this when a brand kit template slide should keep its design and only its text changes. This is the tool for template slides only: an HTML slide goes through add_slide_to_presentation, never through this one. It needs a deck that already exists: presentationId must come from create_presentation. Send the run fields as for add_slide_to_presentation. Pass the kit, the template, the template slide's id, and mapping: the new text for each role, keyed by the role names from get_slide_json for that slide. A role left out keeps the template's text, unless that text is a stand-in such as CAPTION, which is removed. Fixed chrome such as the footnote cannot be changed; page_number is yours to set. Owners and editors only. Deprecated: use add_slide.
add_slide
ChatGPTUse this when adding one slide to a SlidesAI deck. Give exactly one of: html, an HTML slide you wrote; or template, a brand kit template slide that keeps its design and only its text changes. A template slide needs a deck made from that kit's template with create_presentation. Use presentationId from create_presentation. The slide root must match the deck's page size: call get_generation_contract with this presentationId when adding to a deck you did not create in this run.
add_slide_to_presentation
ChatGPTUse this when adding a slide to an existing SlidesAI presentation, such as slides 2+ of a deck made with create_presentation_with_html. Appends one validated HTML slide; use presentationId from create_presentation_with_html. The slide root must match the deck's page size — call get_slide_contract with this presentationId when adding to a deck you did not create in this run.
approve_outline
ChatGPTUse this when the user approves the outline in a chat message: with the outlineId from show_outline, or, when the outline card could not be shown, with the title and slides they approved. Records the approval of the current outline, with any edits made in the card.
choose_look
ChatGPTUse this when the user names the look for their next deck in a chat message rather than in the setup card. Records their choice: a brand kit (brandKitId, plus templateId and mode for a template kit), a SlidesAI style (styleId), or no preference (no look arguments), with the audience, slide count and detail they gave. A pick made in the setup card is already saved.
create_presentation
ChatGPTUse this when the user has approved the outline and the plan is settled. Creates an empty deck and returns presentationId and editorUrl. The SlidesAI editor opens inside the chat automatically; do not paste a link. Its next field holds the build steps: follow them. Pass flow: general (no kit), style (a kit for colours and fonts), or template (a kit template). A template deck also passes mode (exact or freeform, as the user chose), brandKitId and templateId, so the deck takes the template's page.
create_presentation_with_html
ChatGPTUse this when the user wants a new SlidesAI presentation: creates the deck from its first slide's HTML, written against get_slide_contract. Returns presentationId and editorUrl, a link that opens the editable deck in the SlidesAI editor. For multi-slide decks: you MUST send editorUrl to the user in your next message before calling add_slide_to_presentation for slides 2+.
delete_slide
ChatGPTUse this when the user asks to remove one slide from a deck, or when a slide you just added fails its check. Permanent: the slide, its HTML and its picture are removed. The deck stays, even when this leaves it with no slides. Pass presentationId from create_presentation and the slideId from the reply that added the slide. Owners and editors only.
delete_slide_from_presentation
ChatGPTUse this when the user asks to remove one slide from a deck. Permanent: the slide, its HTML and its picture are removed. The deck stays, even when this leaves it with no slides. Pass presentationId from create_presentation and the slideId from the reply that added the slide. Owners and editors only. Deprecated: use delete_slide.
get_design_notes
ChatGPTUse this when the first freeform slide of a deck is about to be built, once per deck. Returns the template's design notes (designMd), the rules every freeform slide from it follows. Its next field is the freeform checklist: follow it for each freeform slide. Owners and editors only. Deprecated: use get_template_design_notes.
get_freeform_reference
ChatGPTUse this when an outline point is switching to freeform, because its content does not fit a template slide, or no slide suits its design. Pass the slideId you chose from the category listing. Returns that reference slide as HTML, with its snapshot, labelled by slide id. Its next field says whether to build from this reference or to pick another slideId. If the template is not AI ready, the reply says so and gives the user the next step. Owners and editors only. Deprecated: use get_reference_slides.
get_generation_contract
ChatGPTUse this when an HTML slide is about to be written: once per deck, before its first one. That covers a generic deck's slide, a style-mode deck's slide, and a freeform slide in a template deck. Not needed for a template slide added with add_slide. Returns the rules for writing a slide: structure, motion, canvas, colours, fonts and the run fields. It sets structure and motion; the design comes from the deck's flow. Keep it: do not call it again for each slide. Always bundled: base, structure, hyperlinks, motion, icon, image. Apply the Structure module to every slide. Pass elements only for the rich modules a slide needs: chart, svg, table, code, math, diagram, mermaid, quiz, embed, mask, shapes, smart-blocks. The response always lists every element and when it fits. For a timeline, pyramid, funnel, peer-card set, bullet list, photo set or Venn request the matching smart-timeline / smart-pyramid / smart-funnel / smart-boxes / smart-bullets / smart-images / smart-venn — native editable elements, not hand-drawn cards. Request only the ones the slide uses; smart-blocks on its own is just a guide to choosing between them, and is not needed to write one. Pass presentationId when adding slides to an existing deck — the contract is served at THAT deck's page size, and a slide root at any other size is rejected on import.
get_kit_templates
ChatGPTUse this when the setup card checks whether a brand kit uploaded in it has its template ready. Called by the card only; the model never calls it.
get_reference_slides
ChatGPTUse this when an outline point is switching to freeform, because its content does not fit a template slide, or no slide suits its design. Pass the templateSlideIds you chose from list_template_slides: one slide when one suits, or two or three that together cover the content. Returns each reference slide as HTML, with its snapshot, labelled by slide id. Its next field says whether to build from these references or to choose others. If the template is not AI ready, the reply says so and gives the user the next step. Owners and editors only.
get_slide
ChatGPTUse this when a slide is already in your deck and you need what it holds: before you change a template slide, or to read an HTML slide's markup. A template slide built in exact mode comes back as JSON, its elements and their text. Any other slide comes back as HTML. Pass format to ask for one form. A slide is changed by replacing it: read it here, delete_slide it if this connection may delete slides, then add_slide the corrected one. Anyone who can view the deck can use this.
get_slide_contract
ChatGPTUse this when the user asks for a presentation, pitch deck or slides made in SlidesAI, or to add slides to a SlidesAI deck — call it before writing any slide HTML. Returns SlidesAI platform HTML contract for one import-safe slide. Always bundled (mandatory): base, structure, motion, icon, image. The Structure module is mandatory — apply it on every run. Pass elements only for the rich modules a slide needs: chart, table, code, math, diagram, mermaid, quiz, svg. Pass presentationId when adding slides to an existing deck — the contract is served at THAT deck's page size, and a slide root at any other size is rejected on import.
get_slide_json
ChatGPTUse this when a template slide needs filling in: it returns the roles you can fill and how many characters each fits. Pass the new text per role to add_branded_slide. The reply includes the slide's snapshot image, so you see the design while you fill it. Owners and editors only. Deprecated: use get_template_slide.
get_slide_screenshot
ChatGPTUse this when you want to see one slide as it looks: a template slide before you choose or fill it (brandKitId, templateId, slideId), or a slide you generated in a deck to check it for breakage (presentationId, slideId). Use it for a closer look at a finalist: the category listing already shows each candidate's snapshot. Returns that single slide's picture as an image, one slide per call. A generated slide the editor has not rendered yet has no picture, and the reply says so. Owners and editors may use a template slide; a generated slide needs access to its deck. Deprecated: use get_slide_screenshots.
get_slide_screenshots
ChatGPTUse this when add_slide has built a slide in your deck, to check it before the next one. Pass the deck's presentationId and up to 9 slide ids from add_slide's replies. Returns one image per slide, in the order given: the editor's rendered picture once the editor has rendered the slide, otherwise a wireframe of its layout and text (source wireframe). A slide with neither is reported in the reply, and the others still come back. Anyone who can view the deck can use this.
get_slides_by_category
ChatGPTUse this when an outline point's content fits a category from get_template_info and you need that category's slides to choose from. Returns the category's slides a page at a time, each with a short summary, whether it is the primary slide for that layout, and its snapshot image labelled with its slide id. That listing is the shortlist for a freeform reference or a template slide, so choose from it. Use get_slide_screenshot for a closer look at one slide. Owners and editors only. Deprecated: use list_template_slides.
get_template_design_notes
ChatGPTUse this when the first freeform slide of a deck is about to be built, once per deck. Returns the template's design notes (designMd), the rules every freeform slide from it follows. Its next field is the freeform checklist: follow it for each freeform slide. Owners and editors only.
get_template_info
ChatGPTUse this when the user has picked a template in a brand kit they can build from, and before create_presentation. Returns the template's layout categories, each with its description and how many slides it holds. Its next field is the plan for every outline point: follow it. Owners and editors only.
get_template_slide
ChatGPTUse this when a template slide needs filling in: it returns the roles you can fill and how many characters each fits. Pass the new text per role to add_slide as template: {templateSlideId, mapping}. The reply includes the slide's snapshot image, so you see the design while you fill it. Owners and editors only.
list_brand_kits
ChatGPTUse this when the user asks for a new deck, or asks which brand kits, styles or templates they have. Lists the brand kits, styles and templates the user can build from, with their role and mode, and shows the setup card where the user picks the look, audience, slide count and detail. A style-mode kit carries its fonts and logos; a template-mode kit carries its templates, each marked ready to build from or not. The optional fields fill the card in with what the user already said.
list_template_slides
ChatGPTUse this when an outline point's content fits a category from get_template_info and you need that category's slides to choose from. Returns the category's slides a page at a time. Each page is one sheet image in a three-by-three grid, one cell per slide, with each cell's slide id and short summary listed beside it. That listing is the shortlist for a freeform reference or a template slide, so choose from it. Owners and editors only.
list_templates
ChatGPTUse this when the user has picked a brand kit from list_brand_kits and wants its templates listed. Each template says whether it is ready to build from. Show the options to the user and wait for their choice before building a deck. Deprecated: use list_brand_kits.
open_editor
ChatGPTUse this when the user wants to see or edit an existing SlidesAI presentation: opens it in the SlidesAI editor. Pass the presentationId from create_presentation or one the user gave you.
record_look
ChatGPTUse this when the setup card records the user's pick. Called by the card only; the model never calls it.
record_outline_approval
ChatGPTUse this when the outline card's Create deck button records the approval. Called by the card only; the model never calls it.
show_deck_ready
ChatGPTUse this when every slide of the deck has been added and checked, with every slide's slideId and title in order. Shows the finished deck as a card with its slide previews and an Open in SlidesAI button; the card lists the slides itself.
show_outline
ChatGPTUse this when an outline is ready for the user to review, and again with the revised draft when they ask for changes. Shows the outline as an editable card in the chat, where the user can change the slides and points and approve it with Create deck.
start_brand_upload
ChatGPTUse this when the brand picker card starts a brand kit upload. Called by the card only; the model never calls it.
validate_slide
ChatGPTUse this when you want to check one slide's HTML against the SlidesAI platform import contract without importing it. Optional — import runs these same checks and returns the same report, so call this when you want to fix a slide without re-importing it. By default, missing entrance animations are auto-added (data-motion-mood + data-motion-order) — see preparedHtml in the response. Smart blocks are checked too: a broken mount/script pair, invalid JSON, an unknown variant or too few items is an error; config keys, values and item fields the client would silently drop, ignore or clamp come back as notices, which never block an import. Pass presentationId whenever the slide is for an existing deck: the canvas check is meaningless without it. Omitted, the root is checked against the default 1280x720, so a correct slide for a non-widescreen deck is reported as the wrong size and a wrong one is reported as fine.
validate_slide_html
ChatGPTUse this when you want to check one slide's HTML against the SlidesAI platform import contract without importing it. Optional — import runs these same checks and returns the same report, so call this when you want to fix a slide without re-importing it. By default, missing entrance animations are auto-added (data-motion-mood + data-motion-order) — see preparedHtml in the response. Set applyDefaultMotion=false only when the user explicitly asked for no animations. Pass presentationId whenever the slide is for an existing deck: the canvas check is meaningless without it. Omitted, the root is checked against the default 1280x720, so a correct slide for a non-widescreen deck is reported as the wrong size and a wrong one is reported as fine.