Skip to main content
POST
/
api
/
partner
/
v1
/
slideshows
/
{slideshowId}
/
render
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0/render \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Slideshow rendered",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "status": "rendered",
    "preview_image_url": "https://cdn.example.com/slideshows/2ab58b/preview.jpg",
    "last_rendered_at": "2026-02-14T09:31:44.000Z",
    "slide_count": 5
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.genviral.io/llms.txt

Use this file to discover all available pages before exploring further.

Triggers slideshow rendering and returns the refreshed slideshow payload.

​
Path Parameters

​
slideshowId
string
required
Slideshow UUID.
This endpoint has no request body.
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0/render \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Slideshow rendered",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "status": "rendered",
    "preview_image_url": "https://cdn.example.com/slideshows/2ab58b/preview.jpg",
    "last_rendered_at": "2026-02-14T09:31:44.000Z",
    "slide_count": 5
  }
}

​
Error Responses

  • 400 missing_slideshow_id - path param missing
  • 404 not_found - slideshow is missing/outside key scope
  • 422 no_slides - slideshow has no slides to render
  • 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 render_failed - unexpected render failure