Skip to main content
POST
Generate a finished editable Pekto presentation

Authorizations

Authorization
string
header
required

Pekto API key (pekto_live_...), an OAuth 2.1 access token from Pekto sign-in (used by MCP clients), or a Pekto user session token.

Body

application/json
topic
string
required

Topic or working title for the presentation

title
string

Optional project title

Maximum string length: 180
content
string

Source text, article, notes, or report content

instructions
string

Audience, tone, or visual direction

slide_count
integer
default:8

Presentations: 3–20 slides. Carousels: 3–30 slides (Instagram itself accepts at most 20).

Required range: 3 <= x <= 30
language
string
default:Auto
format
enum<string>
default:presentation

Use carousel for a LinkedIn or Instagram carousel. Pekto plans each slide (hook, tips, steps, stats, takeaway) and gives every slide a layout from one carousel theme that fits what it says.

Available options:
presentation,
carousel
template_family
string

Optional carousel theme ID (for example carousel37). Valid only when format is carousel; when omitted Pekto picks a theme.

aspect_ratio
enum<string>
default:16:9

Carousel generation always uses the selected family’s native 4:5 geometry.

Available options:
16:9,
4:3,
4:5
include_stock_images
boolean
default:false

Response

Finished presentation project and editor URL