Update Slideshow

curl --request PATCH \
  --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "5 discipline quotes (v2)",
  "settings": {
    "aspect_ratio": "9:16",
    "advanced_settings": {
      "text_width": "narrow"
    }
  }
}'

{
  "ok": true,
  "code": 200,
  "message": "Slideshow updated",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "title": "5 discipline quotes (v2)",
    "status": "draft",
    "slideshow_type": "educational",
    "product_id": null,
    "slide_count": 5,
    "settings": {
      "image_pack_id": "11111111-1111-1111-1111-111111111111",
      "aspect_ratio": "9:16",
      "slideshow_type": "educational",
      "advanced_settings": {
        "font_size": 44,
        "text_preset": "tiktok",
        "text_width": "narrow"
      },
      "pack_assignments": null
    }
  }
}

PATCH

api

partner

slideshows

{slideshowId}

curl --request PATCH \
  --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "5 discipline quotes (v2)",
  "settings": {
    "aspect_ratio": "9:16",
    "advanced_settings": {
      "text_width": "narrow"
    }
  }
}'

{
  "ok": true,
  "code": 200,
  "message": "Slideshow updated",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "title": "5 discipline quotes (v2)",
    "status": "draft",
    "slideshow_type": "educational",
    "product_id": null,
    "slide_count": 5,
    "settings": {
      "image_pack_id": "11111111-1111-1111-1111-111111111111",
      "aspect_ratio": "9:16",
      "slideshow_type": "educational",
      "advanced_settings": {
        "font_size": 44,
        "text_preset": "tiktok",
        "text_width": "narrow"
      },
      "pack_assignments": null
    }
  }
}

Apply a partial update to a slideshow.

Path Parameters

string

required

Slideshow UUID.

Body Parameters

string

Optional title override.

string

Optional status update: draft or rendered.

string

Optional: educational or personal.

string (UUID) | null

Optional product link update. Set null to detach.

object

Optional partial settings patch.

Show Settings Patch

string (UUID) | null

Also accepts legacy camelCase imagePackId.

string

9:16, 1:1, or 4:5.

string

educational or personal.

object

font_size (default, small, or numeric 8-200), text_preset, text_width.

object

Per-slide pack overrides.

array

Optional full slide replacement array.

Show Slide Payload

array

required

At least one element per slide. Element fields: content, x, y, optional id, font_size, width, height, editable, style_preset, font_family, background_color, text_color, border_radius.

string | null

required

Background image URL or null.

string[] | null

Optional collage image URLs.

string | null

2x2, 1+2, vertical, or horizontal.

object

Optional filter object with numeric fields: brightness, contrast, saturation, hue, blur, grayscale, sepia, invert, drop_shadow, opacity.

array

Optional overlays (id, image_url, x, y, width, height, rotation, opacity).

Body cannot be empty. Send at least one updatable field.

If you update slides on a slideshow currently in rendered status, the API automatically resets it to draft and clears render artifacts (preview_image_url, last_rendered_at, and per-slide rendered_image_url).

curl --request PATCH \
  --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "5 discipline quotes (v2)",
  "settings": {
    "aspect_ratio": "9:16",
    "advanced_settings": {
      "text_width": "narrow"
    }
  }
}'

{
  "ok": true,
  "code": 200,
  "message": "Slideshow updated",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "title": "5 discipline quotes (v2)",
    "status": "draft",
    "slideshow_type": "educational",
    "product_id": null,
    "slide_count": 5,
    "settings": {
      "image_pack_id": "11111111-1111-1111-1111-111111111111",
      "aspect_ratio": "9:16",
      "slideshow_type": "educational",
      "advanced_settings": {
        "font_size": 44,
        "text_preset": "tiktok",
        "text_width": "narrow"
      },
      "pack_assignments": null
    }
  }
}

Error Responses

400 invalid_json - body is not valid JSON
422 invalid_payload - schema validation failed or body is empty
404 not_found - slideshow is missing/outside key scope
404 product_not_found - referenced product_id does not exist
403 forbidden_product_access - referenced product_id is outside key scope
401 - authentication failed (missing/invalid/revoked token)
402 subscription_required - active Creator/Professional/Business plan required
403 tier_not_allowed - Scheduler tier cannot use Partner API
500 update_failed - unexpected update failure

Getting Started

Accounts

Posts

Files

Folders

Studio AI

Slideshows

Trends

Packs

Templates

Path Parameters

Body Parameters

Error Responses

​Path Parameters

​Body Parameters

​Error Responses

Path Parameters

Body Parameters

Error Responses