Docs

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 projects
  • project:generate — start a generation run
  • project:ai-chat — edit a project with AI
  • project:export — start and poll PDF/PPTX exports
  • session:read / session:write — track or cancel a run
  • webhook:read / webhook:write — manage webhooks
  • theme: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.

Next steps