{"openapi":"3.1.0","info":{"title":"PowerPointy","description":"Builds designed PowerPoint decks (.pptx) from structured slide content: 14 layouts (title, section, bullets, two-column, comparison, cards, image, native chart, table, quote, big numbers, timeline, agenda, closing), 7 colour themes, speaker notes. Returns the .pptx, a PDF and a slide-preview image attached as a zip (openaiFileResponse) for Code Interpreter display.","version":"2.0.0"},"servers":[{"url":"https://cybrix.ai/pptx","description":"PowerPointy API"}],"paths":{"/health":{"get":{"tags":["meta"],"summary":"Service health check","operationId":"health","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-openai-isConsequential":false}},"/deck":{"post":{"tags":["decks"],"summary":"Build a designed PowerPoint deck from slide content","description":"Returns pptx_url, pdf_url, preview_url (image of the slides), warnings, and attaches the files.","operationId":"create_presentation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-openai-isConsequential":false}}},"components":{"schemas":{"Chart":{"properties":{"type":{"type":"string","enum":["column","bar","line","pie","doughnut","area","stacked"],"title":"Type","default":"column"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"series":{"items":{"$ref":"#/components/schemas/Series"},"type":"array","minItems":1,"title":"Series"},"number_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Number Format","description":"e.g. 0%, $#,##0, 0.0"}},"type":"object","required":["categories","series"],"title":"Chart"},"Column":{"properties":{"heading":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Heading"},"bullets":{"items":{"type":"string"},"type":"array","title":"Bullets","description":"Lines; indent with two spaces for sub-bullets."}},"type":"object","title":"Column"},"DeckRequest":{"properties":{"title":{"type":"string","title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Presenter or company; shown on the title slide."},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"theme":{"type":"string","enum":["modern","minimal","bold","corporate","warm","forest","midnight"],"title":"Theme","description":"Colour scheme.","default":"modern"},"brand_color":{"anyOf":[{"type":"string","pattern":"^#?[0-9A-Fa-f]{6}$"},{"type":"null"}],"title":"Brand Color","description":"Brand primary colour as hex, e.g. #0B5FFF; overrides the theme's primary."},"accent_color":{"anyOf":[{"type":"string","pattern":"^#?[0-9A-Fa-f]{6}$"},{"type":"null"}],"title":"Accent Color","description":"Brand accent colour as hex."},"slides":{"items":{"$ref":"#/components/schemas/Slide"},"type":"array","maxItems":40,"minItems":1,"title":"Slides"},"footer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Footer","description":"Footer text; defaults to the deck title."},"slide_numbers":{"type":"boolean","title":"Slide Numbers","default":true}},"type":"object","required":["title","slides"],"title":"DeckRequest"},"Item":{"properties":{"label":{"type":"string","title":"Label","description":"Heading, step name, stat value or date."},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","description":"Supporting text."}},"type":"object","required":["label"],"title":"Item"},"Series":{"properties":{"name":{"type":"string","title":"Name"},"values":{"items":{"type":"number"},"type":"array","title":"Values"}},"type":"object","required":["name","values"],"title":"Series"},"Slide":{"properties":{"layout":{"type":"string","enum":["title","section","bullets","two_column","comparison","cards","image","chart","table","quote","big_number","timeline","agenda","closing"],"title":"Layout","description":"title, section, bullets, two_column, comparison, cards, image, chart, table, quote, big_number, timeline, agenda, closing.","default":"bullets"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle","description":"title/section/closing: second line."},"bullets":{"items":{"type":"string"},"type":"array","title":"Bullets","description":"bullets/image/chart: lines; indent two spaces for sub-bullets."},"left":{"anyOf":[{"$ref":"#/components/schemas/Column"},{"type":"null"}],"description":"two_column / comparison."},"right":{"anyOf":[{"$ref":"#/components/schemas/Column"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/Item"},"type":"array","title":"Items","description":"cards, big_number, timeline, agenda."},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Public http(s) image for image or bullets layouts."},"image_query":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Image Query","description":"Instead of image_url: a few words to find an openly licensed photo (credited automatically)."},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"chart":{"anyOf":[{"$ref":"#/components/schemas/Chart"},{"type":"null"}]},"table":{"anyOf":[{"$ref":"#/components/schemas/Table"},{"type":"null"}]},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Speaker notes."}},"type":"object","title":"Slide"},"Table":{"properties":{"header":{"items":{"type":"string"},"type":"array","title":"Header"},"rows":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Rows"}},"type":"object","required":["header","rows"],"title":"Table"}}}}