Slides

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} first: the names and current values are in content.slides[].fields, and ONLY those are accepted here. What sits in content.slides[].design is not editable through this endpoint and is refused: on a premium carousel or an infographic the slide is a finished image (use POST /slides/{id}/reimagine), and the free-layout geometry has no text to change. A slide with fields: [] has nothing for this call. Does not change color, font, texture (POST /slides/{id}/style) or the photo.

{
  "slideId": "d32ab31a-073e-471f-8d7a-d145c587e653"
}

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.

{
  "postId": "d9af393d-efcf-4083-b446-15a158eac89c",
  "slideId": "b4dfcd93-31b8-4a9e-a7ed-e6fb38781c29",
  "totalSlides": 8,
  "media": "synced"
}

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

{
  "slideId": "d32ab31a-073e-471f-8d7a-d145c587e653"
}

List a slide's layouts

The layouts this slide can switch to, with the id that POST /slides/{id}/variant expects. Only layouts from the same family as the current one: that is what keeps a carousel looking like one piece. A slide with no layout (the premium carousel and the infographic are finished images) answers invalid_state and points to POST /slides/{id}/reimagine instead of an empty list, because empty would read as "no layouts" when the truth is "this format has none".

{
  "slideId": "d32ab31a-073e-471f-8d7a-d145c587e653",
  "currentLayout": "0f9f4b1e-8a2c-4a0e-9d37-5c9a1b2e7f10",
  "layouts": [
    {
      "id": "0f9f4b1e-8a2c-4a0e-9d37-5c9a1b2e7f10",
      "name": "Headline and body",
      "description": "A title at the top and a paragraph below it.",
      "inUse": true
    },
    {
      "id": "2b7d4e91-3c10-4f6a-8e55-1a0d9c3b7e22",
      "name": "Big number",
      "description": "One figure filling the slide, with a short label.",
      "inUse": false
    }
  ]
}

Change a slide's layout

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

{
  "slideId": "d32ab31a-073e-471f-8d7a-d145c587e653"
}

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. Not for twitter_carousel: use PATCH /slides/{id}/tweet there instead, which is free.

{
  "slideId": "8c0b14d6-d9ad-48f2-8c10-4b7bbcd8dcbc",
  "url": "https://.../post-images/ai-edits/11ddc1b3/0b13691b.webp",
  "used": 1,
  "cap": 2,
  "remaining": 1
}

Edit a Twitter Carousel slide

Only for twitter_carousel slides, which are a rendered image of a tweet rather than a template with fields, so PATCH /slides/{id} has nothing to change there. Send a new text (up to 280 characters), clear the image with imageUrl: null, or both. Free, and does not touch the image-edit budget that POST /slides/{id}/reimagine spends.

{
  "slideId": "b4dfcd93-31b8-4a9e-a7ed-e6fb38781c29",
  "url": "https://.../post-images/twitter-carousel/b4dfcd93/6f2a9d10.png"
}

Delete a tweet slide

Removes one slide from a twitter_carousel post and renumbers the rest, the same rule as DELETE /slides/{id}: a carousel needs at least one slide left. Free.

{
  "removed": "b4dfcd93-31b8-4a9e-a7ed-e6fb38781c29"
}