Skip to Content
TurboslideDocumentation
Slides in ReferenceContents

Slides

The actions of the slide group, with their input fields and their names on every transport.

28 actions: 28 on the command line, 28 as MCP tools, 28 as HTTP endpoints and 28 in the page.

slide.list

List slides. Every slide in deck order with its number, section, title, kind and lint counts.

FieldTypeRequiredDescription
sectionIdstringno
  • Command line: turboslide slides
  • MCP tool: deck_list_slides
  • HTTP: POST /api/actions/slide.list
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: no.

slide.get

Get slide. The normalized slide, the assets it references and its last render record.

FieldTypeRequiredDescription
slideIdstringyes
  • Command line: turboslide slide get <slideId>
  • MCP tool: deck_get_slide
  • HTTP: POST /api/actions/slide.get
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: no.

slide.insert

Insert slide. Inserts a slide into a section after the named slide, or first.

FieldTypeRequiredDescription
sectionIdstringyes
afterstringno
slide{ kind: "content" | "opener" | "mood" | "closing" | "title" | "statement" }yes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide insert --section <sectionId> --after <after> < slide.json
  • MCP tool: deck_insert_slide
  • HTTP: POST /api/actions/slide.insert
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.remove

Remove slide. Removes a slide from the deck and its section.

FieldTypeRequiredDescription
slideIdstringyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide remove <slideId>
  • MCP tool: deck_remove_slide
  • HTTP: POST /api/actions/slide.remove
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.move

Move slide. Moves a slide to a section after the named slide, or first.

FieldTypeRequiredDescription
slideIdstringyes
sectionIdstringyes
afterstringno
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide move <slideId> --to <sectionId> --after <after>
  • MCP tool: deck_move_slide
  • HTTP: POST /api/actions/slide.move
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.update

Patch slide. Applies a mutation list to one slide and returns the normalized slide with its findings.

FieldTypeRequiredDescription
slideIdstringyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
mutations{ op: "slide.insert" | "slide.remove" | "slide.move" | "slide.set" | "slide.replace" | "block.insert" | "block.remove" | "block.move" | "block.set" | "text.replace" | "text.splice" | "text.mark" | "section.set" | "asset.set" | "asset.remove" | "deck.set" | "version.restore" }[]yes
  • Command line: turboslide slide patch <slideId> --set <pointer>=<value>
  • MCP tool: deck_update_slide
  • HTTP: POST /api/actions/slide.update
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.replace

Replace slide. Replaces a slide with the given document; what the source drawer’s Apply emits.

FieldTypeRequiredDescription
slideIdstringyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
slide{ kind: "content" | "opener" | "mood" | "closing" | "title" | "statement" }yes
  • Command line: turboslide slide put <slideId> < slide.json
  • MCP tool: deck_replace_slide
  • HTTP: POST /api/actions/slide.replace
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.setLayout

Set layout. Moves a content slide to another layout and refiles its blocks: to freeform the slide converts to the canvas, every block getting the position box it is drawn at (measured); from freeform the boxes are dropped and the blocks fall into the target slots by geometry (docs/freeform.md).

FieldTypeRequiredDescription
slideIdstringyes
layout{ type: "cols" | "split" | "center" | "left-mid" | "stack" | "freeform" }yesThe target layout with its options
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide set-layout <slideId> --type <type> --ratio <ratio> --gap <gap> --layout <layout>
  • MCP tool: deck_set_layout
  • HTTP: POST /api/actions/slide.setLayout
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.new

New slide. Inserts one slide made from a layout with empty placeholders after the named slide (or first in the section), as one slide.insert with template set; a Section header starts a new section that takes the slides after the anchor.

FieldTypeRequiredDescription
layoutone of 22 valuesyesOne of the layout list
afterstringnoThe slide the new one follows; first in the section when absent
sectionIdstringnoThe section; the anchor's section, or the last section, when absent
idstringnoThe slide id; <layout>-<n> with the first free n when absent. A browser tab mints <layout>-<n>-<four base36 characters of its client id>, so two tabs adding a slide within the same moment never mint one id (docs/archive/rounds/POLISH.md 2.8 item 99)
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide new --layout <layout> --after <after> --section <sectionId> --id <id>
  • MCP tool: deck_new_slide
  • HTTP: POST /api/actions/slide.new
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.duplicate

Duplicate slide. Copies the named slides with fresh ids after the last of them, in one write; a copied section header starts a new section.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide duplicate <slideIds>
  • MCP tool: deck_duplicate_slide
  • HTTP: POST /api/actions/slide.duplicate
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.skip

Skip slide. Sets or clears skip on the named slides in one write: a skipped slide is left out of the slideshow, the shared view, the downloads and the print unless asked.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
skipbooleanyestrue skips the slides, false shows them again
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide skip <slideIds> --off
  • MCP tool: deck_skip_slide
  • HTTP: POST /api/actions/slide.skip
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.applyLayout

Apply layout. Applies a layout to the named slides in one write, one slide.replace per slide: the title, the body, the lists, the tables and the pictures move into the matching placeholders and the rest is appended; only a Title slide or a Main point drops what does not fit, and the output names the dropped blocks.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
layoutone of 22 valuesyesOne of the layout list
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide apply-layout <slideIds> <layout>
  • MCP tool: deck_apply_layout
  • HTTP: POST /api/actions/slide.applyLayout
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.import

Import slides. Copies slides from another deck after the named slide in one write: the assets they use are copied into this deck, colliding slide ids are renamed, and the output lists the slides and the assets that came over.

FieldTypeRequiredDescription
sourceDeckIdstringyesThe deck the slides come from
slideIdsstring[]yesThe slides to copy, in the order they land
afterstringnoThe slide the copies follow; first in the section when absent
sectionIdstringnoThe section; the anchor's section, or the last section, when absent
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide import <sourceDeckId> <slideIds> --after <after> --section <sectionId>
  • MCP tool: deck_import_slides
  • HTTP: POST /api/actions/slide.import
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.toCanvas

Arrange by hand. Converts slides to the canvas, the freeform layout, every object taking the position box it is drawn at (measured on a rendered sheet); a slide already on the freeform layout is left as it is; one write, one browser page for the call.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide to-canvas <slideIds>
  • MCP tool: deck_slide_to_canvas
  • HTTP: POST /api/actions/slide.toCanvas
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.setBackground

Change background. Writes the background colour of slides in one write; null removes it and the theme default applies. A background picture is a picture object at the bottom of the stack.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
background{ color } | nullyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide background <slideIds> --color <color>
  • MCP tool: deck_set_slide_background
  • HTTP: POST /api/actions/slide.setBackground
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.setHtml

Set slide HTML. Writes the HTML and CSS of slides in one write (docs/html-layers.md): CSS scoped to the slide that restyles its blocks, and a markup layer under or over them, over the deck’s shared layer. The markup is sanitized as an html block’s is and the CSS passes the same tokenizer; null removes it.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
html{ css, markup, layer } | nullyescss, markup and layer (under or over); null removes the slide’s layer
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide html <slideIds> [--css <file>] [--markup <file>] [--layer under|over] [--clear]
  • MCP tool: deck_set_slide_html
  • HTTP: POST /api/actions/slide.setHtml
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

text.replaceAll

Find and replace. Replaces every occurrence of a string in the visible text of the deck (every Text of every block, the title slide fields, the table cells and the speaker notes) in one write, case insensitive unless asked; the output counts the replacements.

FieldTypeRequiredDescription
findstringyes
replacestringyes
matchCasebooleannoMatch the case exactly; off by default
slideIdsstring[]noRestrict to these slides
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide text replace <find> <replace> --match-case --slides <slideIds>
  • MCP tool: deck_replace_text
  • HTTP: POST /api/actions/text.replaceAll
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

diagram.insert

Insert diagram. Inserts a diagram template as one group of shape, text and line objects, centred on the sheet unless a box is given; a slide that is not a canvas yet converts first; the output names the ids.

FieldTypeRequiredDescription
slideIdstringyes
kind"grid" | "hierarchy" | "timeline" | "process" | "relationship" | "cycle"yes
countintegeryes
style"outline" | "plate" | "ink"no
posobjectno
afterstringno
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide diagram insert <slideId> --kind <kind> --count <count> --style <style> --pos <pos>
  • MCP tool: deck_insert_diagram
  • HTTP: POST /api/actions/diagram.insert
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.lease

Lease slide. Takes a lease on a slide for the author; another author’s write is rejected with 409 unless forced.

FieldTypeRequiredDescription
slideIdstringyes
minutesintegernoDefaults to 10
forcebooleanno
releasebooleannoGive the author’s lease on the slide back
  • Command line: turboslide lease <slideId> --minutes <minutes> --force --release
  • MCP tool: deck_lease_slide
  • HTTP: POST /api/actions/slide.lease
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes.

motion.list

List animations. A slide's effects in play order, its transition and timed advance as they resolve (the slide's, else the deck's), and the rehearsal schedule: each effect's step, start and end in ms since the slide appeared, with every click at the end of the previous step; the step count and the length. An effect whose block is gone is listed under dangling and skipped by the schedule.

FieldTypeRequiredDescription
slideIdstringyes
  • Command line: turboslide motion list <slideId>
  • MCP tool: deck_list_animations
  • HTTP: POST /api/actions/motion.list
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: no.

motion.add

Add animation. Adds one effect to a slide's block and answers its id: an enter, emphasis or exit effect with a preset (fade, rise-in, slide-in, pop-in, wipe, draw, push-in, float, pulse, type-on, word-rise, line-reveal, glyph-stagger, tracking-in), keyframes on CSS properties or a motion path, starting on a click (the default), with the previous effect or after it, with a delay and a duration (500 ms by default). Refuses a block that is not on the slide and a text preset or split on a block without text.

FieldTypeRequiredDescription
slideIdstringyes
effectobjectyes
indexintegernoWhere the effect goes in play order; last when absent
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide motion add <slideId> --block <blockId> --enter <preset>|--emphasis <preset>|--exit <preset>|--keyframes <json>|--path <d> [--start click|with|after] [--delay <ms>] [--ms <ms>] [--from left|right|top|bottom] [--split line|word|glyph]
  • MCP tool: deck_add_animation
  • HTTP: POST /api/actions/motion.add
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

motion.set

Change animation. Writes one field inside one effect by JSON pointer (/start, /durationMs, /delayMs, /motion/preset, /motion/keyframes/0/style/opacity, ...); an absent value removes the field. The effect must stay valid and its id cannot change.

FieldTypeRequiredDescription
slideIdstringyes
effectIdstringyes
pathstringyesJSON pointer inside the effect, such as /durationMs or /motion/preset
valueunknownnoThe new value; absent removes the field
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide motion set <slideId> <effectId> <path> <value>
  • MCP tool: deck_set_animation
  • HTTP: POST /api/actions/motion.set
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

motion.remove

Remove animation. Removes one effect from a slide; the block stays where it is.

FieldTypeRequiredDescription
slideIdstringyes
effectIdstringyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide motion remove <slideId> <effectId>
  • MCP tool: deck_remove_animation
  • HTTP: POST /api/actions/motion.remove
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

motion.move

Reorder animation. Moves one effect to a place in the slide’s play order, which reorders the steps; an index past the end puts it last.

FieldTypeRequiredDescription
slideIdstringyes
effectIdstringyes
indexintegeryesThe new place in play order, from 0
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide motion move <slideId> <effectId> <index>
  • MCP tool: deck_move_animation
  • HTTP: POST /api/actions/motion.move
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.transition

Transition. Sets how slides enter in the slideshow and the shared view (none, crossfade, slide-fade, rise-fade, scale-fade, zoom-through, blur-swipe, flip-fade, spring-pop, rotate-fade, drift-fade), 0 to 3,000 ms, in one write: on the named slides, or as the deck's transition when no slide ids are given. null removes it; a slide without one takes the deck's, and a deck without one keeps the 120 ms fade and rise.

FieldTypeRequiredDescription
slideIdsstring[]noThe slides; the deck’s transition when absent
transition{ name, durationMs } | nullyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide transition <name>|none [--ms <ms>] [--from left|right|top|bottom] [--slides <slideIds>] [--clear]
  • MCP tool: deck_set_transition
  • HTTP: POST /api/actions/slide.transition
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.advance

Advance. Sets the timed advance in one write: the slideshow moves to the next slide afterMs after the last step of the slide ends, on the named slides or as the deck’s default when no slide ids are given. null removes it, and a click advances.

FieldTypeRequiredDescription
slideIdsstring[]noThe slides; the deck’s advance when absent
advance{ afterMs } | nullyes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide advance <seconds>|off [--slides <slideIds>]
  • MCP tool: deck_set_advance
  • HTTP: POST /api/actions/slide.advance
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.setBackgroundPicture

Background picture. One write for a covering picture object at the back of each named slide with an optional dither, replacing the covering picture already there unless told not to; the file, url and upload forms run asset.add server side first.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
assetIdstringno
filestringnoA path on the machine, or a data: URL
urlstringnoAn http(s) URL fetched through safeFetch
uploadstringnoHosted: the key of a presigned client upload
altstringno
ditherobjectno
replacebooleannoReplace the covering picture at the bottom of the stack; on unless set
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide background-picture <slideIds> --asset <assetId> --file <file> --url <url> --alt <alt> --dither --no-replace
  • MCP tool: deck_set_slide_background_picture
  • HTTP: POST /api/actions/slide.setBackgroundPicture
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

slide.setBackgroundMaterial

Background material. Captures a shader material at an anchor and places the frozen frame as a covering picture object at the back of each named slide with an optional dither, in one call, or stores the frame the client sends with frame without a render; server side.

FieldTypeRequiredDescription
slideIdsstring[]yesOne or more slide ids
materialIdstringyes
presetstringno
uniformsrecordno
anchorintegernoThe moment the still holds, in milliseconds of the pattern's own clock; 5500 when absent
ditherobjectno
frameobjectnoThe frame the editor drew in its own WebGL at the sheet’s aspect (3200 by 1800); with it no browser launches in the function and the bytes are stored under the key derived id the block frames use
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide slide background-material <slideIds> <materialId> --preset <preset> --anchor <anchor> --dither
  • MCP tool: deck_set_slide_background_material
  • HTTP: POST /api/actions/slide.setBackgroundMaterial
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.