Skip to main content
In this guide, you’ll learn how to create a brand new presentation by reusing an existing one as the starting point, then updating only the slides you need — all via the API.
If you haven’t generated your first presentation yet, start with the Generate Presentation Guide. You’ll need at least one presentation ID to follow along.

​
What you’ll do

  • Create a new presentation from an existing presentation (by ID)
  • Update one or more slides by index
  • Download the updated file or continue editing in the web UI

​
Endpoint

POST /api/v1/ppt/presentation/derive
This endpoint takes an existing presentation_id, applies your slide edits, and returns a new presentation.
Slide indices are zero-based. The first slide is index 0, the second is 1, and so on.

​
Before you start (optional but helpful)

Fetch your presentation to see current slide indices, content, and schema: 
GET /api/v1/ppt/presentation/{id}
This response includes:
  • slides[].index: which slide to target
  • slides[].content: fields you can change
For field-by-field details, see the API reference page for
POST /api/v1/ppt/presentation/derive.

​
Step 1 — Decide what to change

Prepare a minimal list of edits. For example, update only the company name on slide 5: 
{
  "presentation_id": "b4fa04dc-0151-4a4d-a2e0-40a51d569afe",
  "slides": [
    {
      "index": 5,
      "content": {
        "companyName": "ABC Company"
      }
    }
  ],
  "export_as": "pptx"
}

​
Step 2 — Send the request

curl -X POST https://api.presenton.ai/api/v1/ppt/presentation/derive \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-xxxxx" \
  -d '{
    "presentation_id": "b4fa04dc-0151-4a4d-a2e0-40a51d569afe",
    "slides": [
      {
        "index": 5,
        "content": {
          "companyName": "ABC Company"
        }
      }
    ],
    "export_as": "pptx"
  }'

​
Step 3 — Understand the response

{
  "presentation_id": "new_unique_presentation_id",
  "path": "/app_data/exports/ABC Company Presentation.pptx",
  "edit_path": "/presentation?id=new_unique_presentation_id"
}
  • presentation_id: the new presentation’s ID
  • path: where the exported file is stored on the server
  • edit_path: open this path in the web app to continue editing visually
Use edit_path to fine-tune layouts, colors, and images in the visual editor.

​
Update multiple slides (advanced)

{
  "presentation_id": "your_presentation_id",
  "slides": [
    { "index": 0, "content": { "title": "New Introduction Title" } },
    { "index": 2, "content": { "companyName": "Updated Company", "revenue": 2500000 } },
    { "index": 5, "content": { "bullets": ["Updated point 1", "Updated point 2", "Updated point 3"] } }
  ],
  "export_as": "pptx"
}

​
Update complex data structures (advanced)

{
  "presentation_id": "your_presentation_id",
  "slides": [
    {
      "index": 3,
      "content": {
        "chartData": [
          {"quarter": "Q1", "revenue": 125000, "growth": 15},
          {"quarter": "Q2", "revenue": 143750, "growth": 18},
          {"quarter": "Q3", "revenue": 168125, "growth": 22},
          {"quarter": "Q4", "revenue": 201750, "growth": 25}
        ]
      }
    }
  ]
}

​
Next steps

  1. Download and share: Use the path to download the new file.
  2. Continue editing: Open edit_path to make visual tweaks in the web editor.

New to Presenton?

Start with our Generate Presentation Guide to learn the basics.