Skip to main content
This guide shows a two-step workflow:
  1. Generate slide outlines with presentation/outlines/generate.
  2. Use each outline as the content for a slide in presentation/generate (sync) or presentation/generate/async (async).

Step 1: Generate outlines

Call the outlines endpoint to get a list of strings. Each string represents a slide outline.
POST /api/v3/presentation/outlines/generate
See the Outlines Generate API Reference for the full request schema.
bash
curl -X POST https://api.presenton.ai/api/v3/presentation/outlines/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-xxxxx" \
  -d '{
    "content": "Quarterly product update for customers",
    "n_slides": 6,
    "language": "English",
    "tone": "professional",
    "verbosity": "standard"
  }'
json
[
  "## Quarterly Product Update for Customers – Q4 2022\n\n- Presenter: Anonymous User\n- Date: 2026-01-20\n- Overview: Review of recent feature releases, pricing changes, customer segmentation tactics, and communication strategies designed to boost efficiency, adoption, and revenue in the fourth quarter.",
  "## Key Highlights from Q4 2022\n\n- Launched independent feature toggles, letting users enable or disable capabilities per package.\n- Introduced new D2E pricing with tiered discounts for higher volume usage.\n- Added out-of-scope billing tools that automate invoicing for extra work.\n- Reported average time savings of 2.5 days per project, boosting delivery speed.",
  "## Feature Enablement and Pricing Model\n\n- Packages support granular feature control, enabling on-demand activation without affecting other services.\n- D2E pricing now has three tiers—basic, professional, enterprise—offering cost efficiencies aligned with usage.\n- Transparent pricing helps budgeting; projected savings reach 15% for high-volume users.\n- Customers can preview cost impact via the pricing calculator before toggling features.",
  "## Customer Segmentation and Targeted Campaigns\n\n- Used Census to activate 360° data, forming granular segments by product usage.\n- Followed a three-step process: activate data, create audiences, deploy via in-app and email.\n- Targeted “Product A” users with specific enhancement announcements, increasing relevance.\n- Resulted in a 12% engagement lift during Q4.",
  "## Communication Strategy and Best Practices\n\n- Adopt quarterly email roundup to keep users informed without inbox overload.\n- Craft role-specific narratives and visuals to highlight benefits for each user segment.\n- Add clear CTA and metrics like 15,000 visitors and 12% growth to show impact.\n- Use Encharge and LiveAgent templates for consistent tone and rapid rollout.",
  "## Roadmap and Next Steps\n\n- Q1 2023 focus: AI-driven insights, expanded API integrations, and enhanced security controls.\n- Release schedule: beta in early February, full rollout by end of March.\n- Invite feedback via in-app surveys; target response rate of 20% to refine upcoming features.\n- Call to action: schedule a demo or contact support for personalized onboarding."
]

Step 2: Generate the presentation from outlines

The presentation/generate endpoint accepts slides, which is an array of objects with:
  • content (string, required)
  • layout (string or null)
Use each generated outline string as a slide’s content and set layout to null (or specify a layout for that slide).

Sync generation

POST /api/v3/presentation/generate
bash
curl -X POST https://api.presenton.ai/api/v3/presentation/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-xxxxx" \
  -d '{
    "slides": [
      {
        "content": "## Quarterly Product Update for Customers - Q4 2022\n\n- Presenter: Anonymous User\n- Date: 2026-01-20\n- Overview: Review of recent feature releases, pricing changes, customer segmentation tactics, and communication strategies designed to boost efficiency, adoption, and revenue in the fourth quarter.",
        "layout": null
      },
      {
        "content": "## Key Highlights from Q4 2022\n\n- Launched independent feature toggles, letting users enable or disable capabilities per package.\n- Introduced new D2E pricing with tiered discounts for higher volume usage.\n- Added out-of-scope billing tools that automate invoicing for extra work.\n- Reported average time savings of 2.5 days per project, boosting delivery speed.",
        "layout": null
      },
      {
        "content": "## Feature Enablement and Pricing Model\n\n- Packages support granular feature control, enabling on-demand activation without affecting other services.\n- D2E pricing now has three tiers—basic, professional, enterprise—offering cost efficiencies aligned with usage.\n- Transparent pricing helps budgeting; projected savings reach 15% for high-volume users.\n- Customers can preview cost impact via the pricing calculator before toggling features.",
        "layout": null
      },
      {
        "content": "## Customer Segmentation and Targeted Campaigns\n\n- Used Census to activate 360° data, forming granular segments by product usage.\n- Followed a three-step process: activate data, create audiences, deploy via in-app and email.\n- Targeted “Product A” users with specific enhancement announcements, increasing relevance.\n- Resulted in a 12% engagement lift during Q4.",
        "layout": null
      },
      {
        "content": "## Communication Strategy and Best Practices\n\n- Adopt quarterly email roundup to keep users informed without inbox overload.\n- Craft role-specific narratives and visuals to highlight benefits for each user segment.\n- Add clear CTA and metrics like 15,000 visitors and 12% growth to show impact.\n- Use Encharge and LiveAgent templates for consistent tone and rapid rollout.",
        "layout": null
      },
      {
        "content": "## Roadmap and Next Steps\n\n- Q1 2023 focus: AI-driven insights, expanded API integrations, and enhanced security controls.\n- Release schedule: beta in early February, full rollout by end of March.\n- Invite feedback via in-app surveys; target response rate of 20% to refine upcoming features.\n- Call to action: schedule a demo or contact support for personalized onboarding.",
        "layout": null
      }
    ],
    "standard_template": "general",
    "export_as": "pdf"
  }'

Async generation

POST /api/v3/presentation/generate/async
Use the same request body as sync, then poll the async task status as described in Generate presentations asynchronously.