edit_tailored_slideshow

Edit a tailored slideshow with Wavegrain's MCP server: the edit_tailored_slideshow tool needs the write permission. Inputs, outputs and an example call.

Edit a tailored slideshow. Permission: write. Changes or removes saved work.

Change a tailored slideshow once its first version is ready: all operations make one new version at once. It takes back the approval, so it does not post by itself until approved again; restore_tailored_version brings back an older version. Answers the slideshow, its sheet and what changed. Free within limits.

Inputs

InputTypeRequiredNotes
slideshowIdstringyesA tailored slideshow id from create_tailored_slideshow or list_slideshows. up to 200 characters
operationsobject[]yesApplied in order as one new version; slide numbers are as each operation finds them. up to 30 items
expectedVersionintegernoThe version you last read (from create_tailored_slideshow, get_tailored_slideshow or the last edit). Pass it: when the slideshow moved on, as after a retried call that timed out, nothing is changed and you are told. 1 to 9007199254740991

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
slideshowIdstringThe tailored slideshow id.
titlestringIts title.
versionnumberThe version this answer is about; each change makes a new one.
status"being_made" | "ready" | "failed"being_made (call get_tailored_slideshow later), ready or failed.
linkstringOpens the slideshow in Wavegrain. Give the user this link.
sheetUrlstring | nullOne image with every slide, numbered; null until ready.
slidesobject[]Each finished slide image; empty until ready.
problemsobject[]Layout problems found when it was made; fix them with edit_tailored_slideshow.
errorstring | nullWhy it failed; null unless status is failed.
styleIdstringThe style it uses.
styleVersionnumberThe style version it was made with.
creditsChargednumberCredits this call spent.
notestringWhat to do next.
summarystringOne line for the user: the title, the slide count and the state.
hooksobject | nullOther hooks for slide 1, written with the words. Switch with edit_tailored_slideshow {op: "set_hook", hookId}; free.
changesstring[]Each change made, in words, by slide number.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the write permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "edit_tailored_slideshow",
    "arguments": {
      "slideshowId": "<slideshowId>",
      "operations": [
        {
          "op": "set_text",
          "slide": 1,
          "slot": "<slot>",
          "text": "<text>"
        }
      ]
    }
  }
}

The call shows only the required inputs, with placeholder values: put your own in.

Something wrong or missing? Write to support@wavegrain.com.