Slides

5 endpoints for slides, with parameters and a real response example.

View as Markdown Open in Claude Open in ChatGPT

PATCH/slides/{id}

Update a slide's fields

Changes one or more text fields of a single slide: title, body, or any other text field the slide's layout has. Use GET /posts/{id}/slides first to learn the field names and current values, and send them exactly as they appeared there. Does not change color, font, texture (POST /slides/{id}/style) or the photo. Carousel only.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`fields`required	body	object	Field name to new value, only for fields the slide's layout accepts. Values are text, up to 2200 characters each, at most 20 fields per request.

DELETE/slides/{id}

Delete a slide

Removes a slide from the carousel and renumbers the rest. Deleting the only remaining slide is rejected: a carousel needs at least one.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.

POST/slides/{id}/style

Update a slide's visual style

Changes the font, colors (background, text, brand), or background texture of a single slide, never the whole post and never the project's brand. Send only the fields that need to change; colors must be hex (#rrggbb).

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`titleFont`	body	string
`bodyFont`	body	string
`backgroundColor`	body	string	Hex, e.g. #112233.
`textColor`	body	string	Hex, e.g. #112233.
`brandColor`	body	string	Hex, e.g. #112233.
`texture`	body	string

POST/slides/{id}/variant

Change a slide's layout variant

Swaps a single slide's layout variant for another one from the catalog.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`layoutId`required	body	string

POST/slides/{id}/reimagine

Reimagine a slide with AI

Only for the formats whose slide is a finished image (premium_carousel and infographic), where the whole slide is AI-designed and the text is baked into the image, so there is no field for PATCH /slides/{id} to change. Describe the change in one sentence and the slide is redesigned, preserving the rest. Limited edits per carousel; GET /posts/{id}/edit-budget reports how many remain.

Parameter	In	Type	Description
`id`required	path	string	Opaque id from a previous response.
`instruction`required	body	string	The change, in one sentence.