Create slideshow edit run
Ask the agent to edit a slideshow at its current revision, optionally targeting a selected element. The asynchronous run preserves an editable project and may spend credits; use an Idempotency-Key for retries.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
a string at most 200 character(s) long
1 - 200Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Slideshow content item id (UUID), as returned by createSlideshow, createSlideshowGeneration, or listSlideshows.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Body
a string at most 8000 character(s) long
1 - 8000a positive number
Text model for this slideshow edit. Omit to use the default. Provider failures may use a fallback; the actual model and cost are recorded.
google/gemini-3.8-flash, anthropic/claude-opus-5.5, openai/gpt-6-sol, anthropic/claude-sonnet-5, openai/gpt-6-luna, x-ai/grok-4.7, deepseek/deepseek-v4.1-flash, qwen/qwen3.8-flash, minimax/minimax-m3, mistralai/mistral-small-2603, moonshotai/kimi-k3, xiaomi/mimo-v2.6-flash, stepfun/step-3.7-flash, google/gemini-3.7-flash, anthropic/claude-opus-5, openai/gpt-5.6-sol, openai/gpt-5.6-terra, x-ai/grok-4.6, deepseek/deepseek-v4-flash-0731, qwen/qwen3.7-plus, moonshotai/kimi-k2.6, xiaomi/mimo-v2.5, google/gemini-3.5-flash, anthropic/claude-opus-4.8, google/gemini-3.1-pro-preview, x-ai/grok-4.5 Reasoning preference supported by the selected model. Omit to use its default. Reasoning tokens may increase the edit cost.
Up to ten sources from this team to ground the edit. Omit for no additional sources.
10a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Up to ten owned images or videos to attach as references for the agent. Omit for no additional media.
10a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$When true, render visual checks for the agent to inspect and polish the edit. Defaults to false; an interactive browser preview is still available.
When true, export the slideshow after the edit commits. Defaults to false; the edit remains an editable draft.
Selected rendered element and its source location or bounds. Omit to edit the whole slideshow.
Response
Success
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$generation, slide_regeneration, edit a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$text, image, layout, style, all an integer
an integer
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$