Beautiful.ai

Creates a Beautiful.ai presentation from a structured outline. Requires a title and an array of slide objects, each with a title, summary, and slide type. Optional advanced controls include a folder id returned by get_folders, theme ID, high-level theme options, image source, image style, language, and exact-text preservation.

Copies a presentation template into its owning workspace and interpolates provided `${variable}` values into the copied presentation.

Exports a Beautiful.ai presentation to PDF or PPTX and returns a temporary signed download URL. For PPTX exports, callers can request either a static image-based deck or an editable deck with pptxMode. Requires an authenticated user with download access to the presentation.

Returns the authenticated user's available presentation folders. Results are separated into My Folders and Team folders and include each folder's id, name, and workspace metadata.

Retrieves an existing Beautiful.ai presentation that the authenticated user can access. Returns playback information for the presentation widget plus editor and export availability when permitted.

Loads a presentation template, scans all string fields for `${variable}` placeholders, and returns the normalized variable inventory.

Returns the available built-in themes plus the authenticated user's saved themes and team themes. Each theme includes ids and metadata such as image style, default status, and workspace association when applicable.

Lists presentation templates available to the authenticated user across their accessible workspaces.

Lists presentations and presentation templates available to the authenticated user across their accessible workspaces. Returns presentation summaries for the accessible results. The response may include a recommended presentation id and next-step metadata when there is a clear best match.

Builds a review package for a structured presentation outline and its selected generation options. Returns an outline preview, option summary, and a review approval token tied to that exact outline and option set.