Create slideshow run
create_slideshow_runCreates a durable multi-page social slideshow run from a structured ContentPack, applying brand settings and returning an authoring URL for review and PNG download.
Instructions
Create a durable multi-page Slideshow Run from a structured ContentPack (platform + pages; each page carries role, slots and either a generated layout { studioJson, canvas } adapted from a Deck Style family, or a layoutFamilyId). Pass brandId to apply the user Brand. Put the post text beside the images in pack.post { title?, description? } (Xiaohongshu / TikTok have a title; Instagram, Threads, LinkedIn and X use description). X image Runs support 2–20 pages and default to the Instagram-compatible 4:5 canvas. Do NOT use to edit an existing run (use update_slideshow_run instead). Requires workspace owner write authorization. Returns created SlideshowRun record with generated runId, initial revision (1), and authoringStudioUrl for interactive browser review and PNG download.
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": {
"pack": "<pack>"
},
"name": "create_slideshow_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pack | Yes | content-pack.v1 payload containing schemaVersion, platform, and pages array with bound templateId and slots content. | |
| brandId | No | Optional Brand ID to apply brand kit typography, colors, and logo to all slides. | |
| contentSlug | No | Optional content topic identifier for tracking in Content Engine. | |
| brandProfileId | No | Optional legacy brand profile ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Unique identifier of the created run. | |
| revision | No | Initial revision number (1). | |
| studioUrl | No | Studio preview and download URL. |