Quick Start
Make your first API call in under 5 minutes.
This guide walks you through creating an API token and generating your first presentation.
Create an API token
Navigate to your workspace settings and create an API token. Select the scopes you need:
project:read/project:write/project:delete— manage projectsproject:generate— start a generation runproject:ai-chat— edit a project with AIproject:export— start and poll PDF/PPTX exportssession:read/session:write— track or cancel a runwebhook:read/webhook:write— manage webhookstheme:read/theme:write— list and manage custom themes through MCP
Copy your token immediately — it will only be shown once.
Make your first request
List your projects to verify your token works:
curl -X GET https://your-instance.com/api/public/v1/projects \
-H "x-api-key: YOUR_API_TOKEN"Generate a presentation
Start a generation run with a brief: what to make, plus any notes or data to build it from.
For decks and proposals, pageCount accepts auto or an integer from 4 to 50, subject to your plan's page limit. A one-pager always generates one page.
curl -X POST https://your-instance.com/api/public/v1/generation/runs \
-H "x-api-key: YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"brief": "Q3 business review: revenue growth, market expansion and the product roadmap.",
"pageCount": "auto"
}'This returns 202 with { "runId", "projectPid", "status": "queued" }. Poll the run every 5–15 seconds; a run takes a few minutes:
curl https://your-instance.com/api/public/v1/generation/runs/RUN_ID \
-H "x-api-key: YOUR_API_TOKEN"status moves through queued, intake, researching, planning,
writing and composing to done, or ends at failed or canceled. link
is the project URL.
Before exporting, also wait for mediaStatus to become settled or skipped; images may still be loading after status reaches done.