Replace text across all your Beautiful.ai decks

1. Search the Beautiful.ai library with Deep Text Search, which lists the presentations that contain a word or phrase anywhere in their slides.
2. Open each presentation from the results and press Ctrl+F (Command+F on a Mac), the Find and Replace shortcut in the Beautiful.ai editor.
3. Replace the phrase in that deck, then go back to the Beautiful.ai library and open the next search result, one presentation at a time.
4. If the phrase sits on a Team Slide, only an Owner or Librarian can change it, through Edit Shared Slide or Team Resources > Team Slides > Shared Slides.
5. Nothing records which decks are already fixed, so a deck in a colleague's folder or a similar spelling ("Acme insights", "AcmeInsights") is easy to miss.

We renamed Acme Insights to Acme Pulse. Find every deck in the Sales folder that still says Acme Insights, show me the matches, then replace them.

1. 01

   Agree on the scope first

   The agent asks which decks count: one folder, titles with a keyword, or everything you can open. It resolves the folder name with list_folders and pulls the decks with list_presentations. Decks owned by someone else are listed separately and left alone unless you include them.

2. 02

   Collect every match before changing one

   For each deck the agent reads all slides with get_slides and records slide number, layout and the full line around the phrase. It also flags near misses with different case or spacing, so you decide whether "Acme insights" counts.

3. 03

   Show the list and wait

   You get a count per deck and the lines that will change. Lines where a plain swap would read wrong, such as a sentence that explains the old name, are marked for you to word by hand.

4. 04

   Replace slide by slide

   After your yes, update_slide_text runs once per matching slide with the exact text found. When a slide returns 0 replacements because someone edited it in the meantime, the agent rereads that slide instead of guessing.

5. 05

   Report what stayed

   The run ends with decks changed, slides changed and the matches left on purpose. A deck that should keep the old wording, like last year's archive, stays untouched when you name it.

Scope: Sales folder, 14 decks. Searched for "Acme Insights".
Acme Pulse overview: 6 slides changed (2, 3, 5, 8, 9, 12).
Q3 QBR, Northwind: 2 slides changed (4, 11).
Renewal playbook (owner: Maria Lopez): 3 matches, skipped, not your deck.
Pricing one-pager: slide 6 says "formerly Acme Insights", kept as written.
Near miss: "AcmeInsights" on slide 2 of Partner kit, not changed. Say if it should be.
11 decks had no match.

• Beautiful.ai Deep Text Search finds every instance of a term across all your presentations, and in Shared Slides or Copy Slides it filters results by Presentation Title, Slide Content or Template.
• Beautiful.ai lists Find and Replace among its editor keyboard shortcuts: Ctrl+F on Windows and Command+F on a Mac.
• A Beautiful.ai Team Slide updates in every presentation that uses it, and Shared Slides Properties lists those presentations under Where Is This Slide Used.
• Beautiful.ai Version History (a Pro feature) keeps earlier versions of each slide under Manage > Revert to Previous Version, with the editor's name on shared decks.
• Beautiful.ai Version History also lists the slides deleted from a presentation and recovers each one with a click.

update_slide_text and duplicate_presentation change only your own Beautiful.ai data and reach no one else, so they run without asking first.

Sources: Beautiful.ai: Deep Text Search · Beautiful.ai: Keyboard Shortcuts · Beautiful.ai: How do I update/edit a Team Slide? · Beautiful.ai: Version History

curl https://cotlet.dev/api/v1/beautiful-ai/update_slide_text \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"presentation_id":"pres_8f3k2m9q","slide_number":4,"find":"Acme Insights","replace":"Acme Pulse"}'

{
  "presentation_id": "pres_8f3k2m9q",
  "slide_number": 4,
  "replaced": 1,
  "slide_text": [
    "FY26 targets",
    "Grow ARR 40%",
    "Launch in two new regions"
  ]
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is beautiful-ai_update_slide_text. Example data.

• Write speaker notes for a Beautiful.ai deck with AI
• See who viewed your Beautiful.ai deck each week
• Beautiful.ai API and MCP server: every tool
• All use cases