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
| Input | Type | Required | Notes |
|---|---|---|---|
slideshowId | string | yes | A tailored slideshow id from create_tailored_slideshow or list_slideshows. up to 200 characters |
operations | object[] | yes | Applied in order as one new version; slide numbers are as each operation finds them. up to 30 items |
expectedVersion | integer | no | The 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
| Field | Type | Notes |
|---|---|---|
slideshowId | string | The tailored slideshow id. |
title | string | Its title. |
version | number | The 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. |
link | string | Opens the slideshow in Wavegrain. Give the user this link. |
sheetUrl | string | null | One image with every slide, numbered; null until ready. |
slides | object[] | Each finished slide image; empty until ready. |
problems | object[] | Layout problems found when it was made; fix them with edit_tailored_slideshow. |
error | string | null | Why it failed; null unless status is failed. |
styleId | string | The style it uses. |
styleVersion | number | The style version it was made with. |
creditsCharged | number | Credits this call spent. |
note | string | What to do next. |
summary | string | One line for the user: the title, the slide count and the state. |
hooks | object | null | Other hooks for slide 1, written with the words. Switch with edit_tailored_slideshow {op: "set_hook", hookId}; free. |
changes | string[] | 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.
Related tools
pin_style: Pin a style to a brandunpin_style: Unpin a style from a brandcreate_upload: Upload an imagerestore_tailored_version: Restore a tailored versionupdate_caption: Change a post captioncancel_queued_post: Cancel a queued post- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.