Skip to main content
POST
Create a manual slideshow
Create an editable draft from slides you write yourself, without generation or credits. This is the path for a caller-written deck: you supply the copy, the images and any brand rules, and Genviral stores them as given.
  • Place text with x/y, or with placement (top, center or bottom) and an optional role; text that cannot fit is refused with text_overflow. Dry-run the same body with POST /api/partner/v1/slideshows/validate first.
  • aspect_ratio defaults to 4:5; send 9:16 for TikTok decks.
  • background_filters takes only the filters you change; omitted filters use their defaults.
  • caption and hashtags are stored on the deck and used by POST /api/partner/v1/posts/prepare when the post names media.slideshow_id and sends no caption.
  • The response is the editable deck (id, status, revision, slides). Retrying with the same Idempotency-Key returns the same deck; never retry a create with a new key.