Prezi

Use this when the user wants to create, make, generate, or draft a presentation, slide deck, pitch deck, or slides from a topic, idea, outline, or notes — e.g. "make me a presentation about renewable energy" or "I need slides for Monday's meeting." Creates a new Prezi presentation from a single topic. Returns the presentation ID, an edit URL, a share URL, and (when available) a thumbnail URL. Do not use when the user shared a file: for a PowerPoint (.pptx) use import_pptx; for a PDF use rebuild_from_content. Do not use to change an existing presentation — use modify_presentation.

create_presentation

Use this when the user wants to make a finished presentation interactive or engage their audience — a quiz, word cloud, podcast version, PDF handout, or other audience apps — e.g. "add a quiz to my deck" or "how can I make this more engaging?" Returns the Prezi Room apps recommended for this specific deck; each suggestion's url opens the Room with that app already launched. Requires generated slides — call only after the deck is past generating (confirm via get_presentation_status).

get_room_app_suggestions

Get a presentation's slide markup for the inline preview to render. Called programmatically by the preview UI once the deck has viewable slides — not a response to a direct user request. Do not use to list or open the user's presentations (use list_presentations).

get_presentation_slides

Check the generation status of a Prezi presentation that is currently being created. Call this programmatically — poll every ~3 seconds after create_presentation — to know when the deck is viewable and when the animated preview is ready. Not a response to a direct user request; do not use to list or open the user's presentations (use list_presentations).

get_presentation_status

Use ONLY when the user explicitly asks for a page-faithful visual copy of a PDF: each page becomes one image slide — pages are images, not editable text, and no navigable overview is generated. For most PDF requests ("turn this PDF into a presentation"), use rebuild_from_content instead: read the PDF's text and outline and pass it as content to generate an editable, navigable Prezi. Provide the file as fileUrl or fileBase64. Returns an edit URL immediately; slides appear in the background after ~30–40 seconds.

import_pdf

Use this when the user shared a PowerPoint (.pptx) file and wants it in Prezi — e.g. "convert my PowerPoint to Prezi" or "import this .pptx." Performs a true high-fidelity import of the original slides into a new Prezi presentation. Provide the file as uploadToken (from request_pptx_upload — preferred for a chat attachment), fileUrl, or fileBase64. Returns an edit URL immediately; slides are imported in the background and appear at the URL after ~60–90 seconds. If the file's bytes or URL can't be provided, use rebuild_from_content instead. Do not use for PDFs or plain topics.

import_pptx

Use this when the user asks to see, list, find, or reopen their recent Prezi presentations — e.g. "show my recent decks" or "open the presentation I was working on yesterday." Returns up to 9 of the user's most recently edited presentations, each with an edit URL to open it in the editor. Read-only; do not use to create or modify presentations.

list_presentations

Use this when the user wants to change an existing Prezi presentation — add, edit, rewrite, reorder, or delete slides, change the theme or design, shorten or expand the content — e.g. "add a slide about pricing" or "make the deck more formal." Requires the presentationId and a natural-language instruction. The edit runs in the background; returns the edit URL immediately. Do not use to create a new presentation (create_presentation) or to import a file (import_pptx / rebuild_from_content).

modify_presentation

Use this when the user shared a PowerPoint or PDF and wants it turned into an editable Prezi presentation — read the file's text and outline yourself and pass it as content. This is the default path for PDFs (it produces an editable, navigable Prezi rather than page images), and the fallback path for PowerPoints when the file's bytes or URL can't be handed to import_pptx. Returns an edit URL plus a rebuild notice and an editor call-to-action for true branding/styling import. Do not use for a plain topic with no source file — use create_presentation.

rebuild_from_content

Internal preparation step for import_pptx — never call in response to a user prompt on its own. Use when the user attached a .pptx whose bytes you can read from disk and PUT via code: mints an upload URL and a user-bound token so the file's exact bytes are uploaded out-of-band without passing through the conversation. Then call import_pptx with the returned uploadToken.

request_pptx_upload