# Presentations The actions of the deck group, with their input fields and their names on every transport. 32 actions: 32 on the command line, 26 as MCP tools, 27 as HTTP endpoints and 26 in the page. ## deck.info **Deck info.** Title, theme, sections with slide ids and titles, counts (the canvas slides, charts and guides included) and the current revision. It takes no input. * Command line: `turboslide info` * MCP tool: `deck_get_info` * HTTP: `POST /api/actions/deck.info` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## deck.create **New deck.** Creates a deck under decks/ from a template of the index (template.list), the deployment default when `from` is absent (Blank: one title slide in the Simple theme, light), and returns its id, revision and counts. | Field | Type | Required | Description | | ------ | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | yes | The deck title; the id is its slug unless `id` is given | | `from` | string | no | A template id of the index (template.list): 'blank' writes one title slide in the Simple theme; 'gt-brand' copies the General Translation brand deck (95 slides, 8 sections, the assets); a saved template copies its folder. The deployment default (template.list `default`) when absent | | `id` | string | no | The deck id under decks/; derived from the name when absent | * Command line: `turboslide deck create --from --id ` * MCP tool: `deck_create` * HTTP: `POST /api/actions/deck.create` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes. ## deck.rename **Rename deck.** Sets the deck title, the name the sidebar head, the toolbar and the deck list show; one deck.set of /title. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `name` | string | yes | The new title | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck rename ` * MCP tool: `deck_rename` * HTTP: `POST /api/actions/deck.rename` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.set **Set a deck field.** Writes one field of the deck manifest by JSON pointer (/title, /theme, /defaults/appearance, /defaults/counter, /defaults/notes) as one deck.set mutation, the write the Theme panel and Slide numbers make; an absent value removes the field. /theme takes an id of theme.list (gt-ink-paper is stored as general-translation). | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------- | | `path` | string | yes | JSON pointer into the manifest: /title, /theme, /defaults/appearance, /defaults/counter or /defaults/notes | | `value` | unknown | no | The new value; omit it to remove the field | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck set ` * MCP tool: `deck_set` * HTTP: `POST /api/actions/deck.set` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.pack **Pack deck bundle.** Writes decks/\ (deck.json, slides, assets, versions and the sidecars) as one zip with a manifest.json carrying the bundle version, the deck id, its revision and a digest per file (docs/deck-transfer.md). | Field | Type | Required | Description | | ---------- | ------- | -------- | -------------------------------------------------------------------- | | `id` | string | yes | The deck id under decks/ | | `out` | string | no | The zip to write; defaults to \-r\.zip | | `versions` | boolean | no | Carry versions/\.json; on by default (--no-versions turns it off) | * Command line: `turboslide deck pack --out ` * MCP tool: No MCP tool. * HTTP: No HTTP endpoint. * Runs on: command line. * Changes the presentation: no. ## deck.unpack **Unpack deck bundle.** Creates a deck under decks/ from a bundle zip after validating it, under a free id when the bundle id is taken unless `replace` removes the deck that holds it (docs/deck-transfer.md). | Field | Type | Required | Description | | --------- | ------- | -------- | ---------------------------------------------------------------------------------- | | `file` | string | yes | The bundle zip to read | | `as` | string | no | The deck id to write under; the bundle id when absent | | `replace` | boolean | no | Remove the deck that holds the id first; without it a taken id gets a free sibling | * Command line: `turboslide deck unpack --as --replace` * MCP tool: No MCP tool. * HTTP: No HTTP endpoint. * Runs on: command line. * Changes the presentation: yes. ## deck.push **Push deck to a studio.** Packs decks/\ and uploads the bundle to a hosted studio through POST /api/decks/bundle with the bearer token, so the deck can be edited there (docs/deck-transfer.md). | Field | Type | Required | Description | | --------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | yes | The deck id under decks/ | | `to` | string | yes | The studio, such as [https://turboslide.vercel.app](https://turboslide.vercel.app) | | `token` | string | no | The bearer token (TURBOSLIDE_TOKEN of the deployment); kept in \~/.config/turboslide/hosts.json after the first use | | `as` | string | no | The id the deck takes on the studio; the local id when absent | | `replace` | boolean | no | Replace the deck of that id on the studio | | `fromUrl` | string | no | A bundle already stored at a URL the studio may read (the deck store Blob host); the studio fetches it instead of receiving the bytes, for bundles over a function 4.5 MB body cap | * Command line: `turboslide deck push --to --token --as --replace --from-url ` * MCP tool: No MCP tool. * HTTP: No HTTP endpoint. * Runs on: command line. * Changes the presentation: yes. ## deck.pull **Pull deck from a studio.** Downloads a deck bundle from a hosted studio through GET /api/decks/\/bundle with the bearer token and unpacks it into decks/, so the deck can be edited locally (docs/deck-transfer.md). | Field | Type | Required | Description | | --------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------- | | `id` | string | yes | The deck id on the studio | | `from` | string | yes | The studio, such as [https://turboslide.vercel.app](https://turboslide.vercel.app) | | `token` | string | no | The bearer token (TURBOSLIDE_TOKEN of the deployment); kept in \~/.config/turboslide/hosts.json after the first use | | `as` | string | no | The id the deck takes under decks/; the id on the studio when absent | | `replace` | boolean | no | Replace the local deck of that id | * Command line: `turboslide deck pull --from --token --as --replace` * MCP tool: No MCP tool. * HTTP: No HTTP endpoint. * Runs on: command line. * Changes the presentation: yes. ## deck.list **List decks.** The manifest facts of every deck under decks/ (id, title, slide and section counts, revision, the stamps), newest first; decks in the trash are left out unless asked. | Field | Type | Required | Description | | ---------------- | ------- | -------- | --------------------------------------------------------- | | `includeTrashed` | boolean | no | Also list the decks in the trash, each with its trashedAt | * Command line: `turboslide deck list --include-trashed` * MCP tool: `deck_list` * HTTP: `POST /api/actions/deck.list` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## deck.copy **Make a copy.** Copies a deck under a new id with a new title, every slide or the named ones, with or without the speaker notes, at revision 0 with an empty version log; the output names the new deck. | Field | Type | Required | Description | | -------------- | --------- | -------- | ----------------------------------------------------------------------------------- | | `id` | string | yes | The deck to copy | | `name` | string | yes | The title of the copy; its id is the slug unless `newId` is given | | `newId` | string | no | The id of the copy under decks/ | | `slideIds` | string\[] | no | Copy these slides only, in deck order; every slide when absent | | `removeNotes` | boolean | no | Leave the speaker notes out of the copy | | `copyComments` | boolean | no | Carry the comment threads into the copy with their ids; off by default | | `baseRevision` | integer | yes | The revision of the source deck the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck copy --name --id --slides --remove-notes --copy-comments` * MCP tool: `deck_copy` * HTTP: `POST /api/actions/deck.copy` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.trash **Move to trash.** Moves a deck to the trash by writing trashedAt on its manifest: the home page, the fresh presentation route and deck.list leave it out until deck.restore clears the stamp or deck.remove deletes it; nothing else changes. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `id` | string | yes | The deck to move to the trash | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck trash ` * MCP tool: `deck_trash` * HTTP: `POST /api/actions/deck.trash` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.restore **Restore from trash.** Clears trashedAt on a deck in the trash, so the home page and deck.list show it again. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `id` | string | yes | The deck to restore | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck restore ` * MCP tool: `deck_restore` * HTTP: `POST /api/actions/deck.restore` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.remove **Delete forever.** Deletes a deck: the folder under decks/ or the prefix in the Blob store, with its slides, assets and version log. Irreversible; the Trash page calls it, and `confirm` must be true. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `id` | string | yes | The deck to delete | | `confirm` | true | yes | The caller has confirmed the deletion | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck remove --confirm` * MCP tool: No MCP tool. * HTTP: `POST /api/actions/deck.remove` * Runs on: command line, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.setBackground **Set theme background.** Writes the background colour every slide without its own takes, what Add to theme writes; null removes it. | Field | Type | Required | Description | | -------------- | -------------- | -------- | ---------------------------------------------------------------- | | `background` | object \| null | yes | The colour, a palette token or a hex; null removes the default | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck background --color ` * MCP tool: `deck_set_background` * HTTP: `POST /api/actions/deck.setBackground` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## deck.guides **Set guides.** Adds, removes, moves, sets or clears the deck’s guide lines, sheet pixels the same on every slide; the result is sorted and inside the sheet, and an empty result removes the field. | Field | Type | Required | Description | | -------------- | --------- | -------- | ---------------------------------------------------------------- | | `add` | object\[] | no | | | `remove` | object\[] | no | | | `move` | object\[] | no | | | `set` | object | no | Replace both lists | | `clear` | true | no | Remove every guide | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide deck guides --add-vertical --add-horizontal --remove-vertical --remove-horizontal --set --clear` * MCP tool: `deck_set_guides` * HTTP: `POST /api/actions/deck.guides` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## template.list **Templates.** The template index: every template with its name, category, cover, sentence, slide count, theme and appearance, the organisation flag of a template saved on this deployment and its brand kit, plus the id of the template new presentations start from. It takes no input. * Command line: `turboslide template list` * MCP tool: `deck_list_templates` * HTTP: `POST /api/actions/template.list` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## template.slides **Template slides.** The slides of one template in order with their titles and kinds, the rows the gallery and Import slides read. | Field | Type | Required | Description | | ----- | ------ | -------- | --------------- | | `id` | string | yes | The template id | * Command line: `turboslide template slides ` * MCP tool: `deck_template_slides` * HTTP: `POST /api/actions/template.slides` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## template.create **Save as template.** Saves a deck as a template of this deployment: decks/templates/\ with the deck manifest, its slides, its assets and its brand kit, listed under Your organisation in the gallery; a name an organisation template already carries replaces that template and keeps its slug (the dialog says so first). | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------------------- | | `deckId` | string | yes | The deck to save | | `name` | string | yes | The template name; its slug is the template id | | `sentence` | string | no | One sentence the gallery card shows; "Saved from \" when absent | | `baseRevision` | integer | yes | The revision of the deck the caller read; a stale value is rejected with 409 | * Command line: `turboslide template create --sentence ` * MCP tool: `deck_create_template` * HTTP: `POST /api/actions/template.create` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## template.update **Replace a template.** Replaces the slides, assets and brand kit of an organisation template from a deck and keeps its id, name and sentence; the templates Turboslide ships are refused. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------------------- | | `id` | string | yes | The template to replace | | `deckId` | string | yes | The deck whose slides replace it | | `sentence` | string | no | A new sentence; the old one when absent | | `baseRevision` | integer | yes | The revision of the deck the caller read; a stale value is rejected with 409 | * Command line: `turboslide template update ` * MCP tool: `deck_update_template` * HTTP: `POST /api/actions/template.update` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## template.rename **Rename a template.** Renames an organisation template; its id and its folder stay, so every link and every default record still name it. The templates Turboslide ships are refused. | Field | Type | Required | Description | | ------ | ------ | -------- | ---------------------- | | `id` | string | yes | The template to rename | | `name` | string | yes | The new name | * Command line: `turboslide template rename ` * MCP tool: `deck_rename_template` * HTTP: `POST /api/actions/template.rename` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes. ## template.delete **Delete a template.** Deletes an organisation template folder and its index row; presentations made from it are not changed. The template new presentations start from is refused until another is chosen, and so are the templates Turboslide ships. Irreversible; `confirm` must be true. | Field | Type | Required | Description | | --------- | ------ | -------- | ------------------------------------- | | `id` | string | yes | The template to delete | | `confirm` | true | yes | The caller has confirmed the deletion | * Command line: `turboslide template delete --confirm` * MCP tool: `deck_delete_template` * HTTP: `POST /api/actions/template.delete` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes. ## template.setDefault **Use for new presentations.** Makes a template the one /new and the Blank card start from on this deployment (decks/templates/default.json), whose name, logo and appearance every Reset and every default logo read; `blank` restores the blank deck Turboslide ships. An agent token needs the admin scope. | Field | Type | Required | Description | | ----- | ------ | -------- | ----------------------------------------- | | `id` | string | yes | The template new presentations start from | * Command line: `turboslide template default ` * MCP tool: `deck_set_default_template` * HTTP: `POST /api/actions/template.setDefault` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes. ## section.set **Set sections.** Replaces the section list, the only place slide order lives. | Field | Type | Required | Description | | -------------- | --------- | -------- | ---------------------------------------------------------------- | | `sections` | object\[] | yes | | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide sections set < sections.json` * MCP tool: `deck_set_sections` * HTTP: `POST /api/actions/section.set` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## import.run **Import deck.** Imports the Prototemplate deck HTML into a Turboslide deck and writes the import report. | Field | Type | Required | Description | | ------ | ------ | -------- | ----------- | | `from` | string | yes | | | `into` | string | yes | | * Command line: `turboslide import --into ` * MCP tool: No MCP tool. * HTTP: No HTTP endpoint. * Runs on: command line. * Changes the presentation: yes. ## validate.run **Validate.** Validates a deck directory and returns the issues and the normalized document. | Field | Type | Required | Description | | ------ | ------ | -------- | -------------------------------------------- | | `path` | string | no | Deck directory; defaults to the current deck | * Command line: `turboslide validate ` * MCP tool: `deck_validate` * HTTP: `POST /api/actions/validate.run` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## deck.tailor **Tailor for a customer.** The tailoring pass as one write: replaces the customer name in every visible text and the notes, swaps the pictures whose alt text names the old customer for one asset, and skips the named slides; answers the counts per step and the slides that changed. | Field | Type | Required | Description | | -------------- | --------- | -------- | --------------------------------------------------------------------------------- | | `replacements` | object\[] | no | Case insensitive, over every visible text and the notes, as Find and replace runs | | `logo` | object | no | | | `skip` | string\[] | no | The slides to skip | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide tailor --replace = --skip --logo --logo-alt ` * MCP tool: `deck_tailor` * HTTP: `POST /api/actions/deck.tailor` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## assist.propose **Ask the assistant.** Asks the assistant for a proposal over the named slides: a shorter rewrite or speaker notes, or a free ask that resolves to one of the two; answers signed cards a caller accepts with assist.accept. A read: nothing is written until a card is accepted. | Field | Type | Required | Description | | -------------- | ----------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `intent` | "shorter" \| "notes" \| "ask" | yes | 'shorter' rewrites the slide’s text shorter, 'notes' writes speaker notes, 'ask' resolves the prompt to one of the two | | `prompt` | string | yes | The seller’s ask, in their words; empty for a starter card | | `slideIds` | string\[] | no | The slides the ask is about; the deck’s first slides when absent | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide assist propose --intent --slides ` * MCP tool: `deck_assist_propose` * HTTP: `POST /api/actions/assist.propose` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## assist.accept **Accept a proposal.** Writes one card assist.propose returned, as one write by the assistant: the signature, the expiry and the deck are verified, a card behind the deck is re based when its blocks are unchanged and refused otherwise. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `card` | object | yes | | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide assist accept < card.json` * MCP tool: `deck_assist_accept` * HTTP: `POST /api/actions/assist.accept` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## brand.get **Brand kit.** The brand kit record of the deck: the colour roles, the faces, the logo and footer slots, the slide numbers, the frame toggles and the words that never translate, drawn over the deck’s theme; an empty object for a deck that draws its theme alone. It takes no input. * Command line: `turboslide brand get` * MCP tool: `deck_brand_get` * HTTP: `POST /api/actions/brand.get` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: no. ## brand.set **Set a brand kit field.** Writes one value of the brand kit by JSON pointer (/colors/light/primary, /fonts/display, /mark, /footer/logo, /footer/text, /counter/format, /frame/rails, /positions/mark, /lexicon, /appearance, /name) as one deck.set mutation under /brand, the write every Brand kit panel control makes; an absent value removes the field. The record is validated before the commit. | Field | Type | Required | Description | | -------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `path` | string | yes | A JSON pointer into the kit: /colors/\/\, /fonts/\, /mark, /footer/\, /counter/\, /frame/\, /positions/\, /lexicon, /appearance, /name | | `value` | unknown | no | The new value; omit it to remove the field | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide brand set ` * MCP tool: `deck_brand_set` * HTTP: `POST /api/actions/brand.set` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## brand.reset **Reset the brand kit.** Removes the brand kit record, so the deck draws its theme alone (theme.list), or one field of it when a pointer is given, which then reads the theme’s value; a deck with nothing to remove writes no revision. | Field | Type | Required | Description | | -------------- | ------- | -------- | ---------------------------------------------------------------- | | `path` | string | no | One field to remove; the whole record when omitted | | `baseRevision` | integer | yes | The revision the caller read; a stale value is rejected with 409 | * Command line: `turboslide brand reset [path]` * MCP tool: `deck_brand_reset` * HTTP: `POST /api/actions/brand.reset` * Runs on: command line, MCP, HTTP, page. * Changes the presentation: yes; send the `baseRevision` you read. ## theme.list **Themes.** The theme library: each of the nine themes with its id, name, one sentence, the appearance a deck in it draws when none is chosen, and its twelve sheet tokens per appearance. deck.set /theme takes any of the ids; a brand kit draws over the theme. It takes no input. * Command line: `turboslide theme list` * MCP tool: `deck_list_themes` * HTTP: `POST /api/actions/theme.list` * Runs on: command line, MCP, HTTP. * Changes the presentation: no.