# 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.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**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](/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](/developers/authentication) shows how to make one.

```json
{
  "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`](/developers/mcp-tools/pin_style): Pin a style to a brand
- [`unpin_style`](/developers/mcp-tools/unpin_style): Unpin a style from a brand
- [`create_upload`](/developers/mcp-tools/create_upload): Upload an image
- [`restore_tailored_version`](/developers/mcp-tools/restore_tailored_version): Restore a tailored version
- [`update_caption`](/developers/mcp-tools/update_caption): Change a post caption
- [`cancel_queued_post`](/developers/mcp-tools/cancel_queued_post): Cancel a queued post
- [All 79 tools](/developers/mcp-tools)
