Update slideshow run
update_slideshow_runPartially update an existing Slideshow Run by runId to patch slide copy, layout, styling, or brand settings while preserving unspecified fields; include baseRevision to prevent overwrite conflicts.
Instructions
Partially update slide copy, slot bindings, layout, styling, or brand settings of an existing Slideshow Run by runId. Call get_slideshow_run first to obtain current revision and slide data. Do NOT use to create new runs (use create_slideshow_run) or delete runs (use delete_slideshow_run). Safe partial patch: unspecified fields are preserved. Requires baseRevision for optimistic concurrency locking; on revision mismatch returns 409 Conflict (no auto-merge), requiring a fresh get_slideshow_run. To patch a single slide, provide pageIndex (0-indexed) with slots, layout, or style. To update entire deck, provide pack. Returns updated SlideshowRun with incremented revision number.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"runId": "<runId>"
},
"name": "update_slideshow_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pack | No | Updated complete content-pack.v1 structure. Overrides entire slide deck when provided. | |
| post | No | The post text beside the images: { title?, description? }. Only the fields in the Run's postLimits exist on its platform; keep within those limits. | |
| runId | Yes | The unique Slideshow Run identifier to update. | |
| slots | No | Key-value map of slot text/image overrides for the specified pageIndex. | |
| style | No | Style token adjustments for the specified pageIndex. | |
| layout | No | Layout adjustments for the specified pageIndex. | |
| brandId | No | Updated Brand ID styling reference applied across slides. | |
| pageIndex | No | Index of a single slide page to patch (0-indexed). Must be paired with slots, layout, style, or decorations. | |
| contentSlug | No | Updated content topic slug. | |
| decorations | No | Visual decorations list for the specified pageIndex. | |
| baseRevision | No | Current revision number for optimistic concurrency locking to prevent overwrite races. Must match latest revision from get_slideshow_run. | |
| brandProfileId | No | Optional legacy brand profile ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Run identifier. | |
| revision | No | Incremented revision number. | |
| studioUrl | No | Studio review URL. |