Generate single slide (async)
Generate a single slide asynchronously from a template slide and your data.
Workflow:
- Upload and analyze a template first (see Templates endpoints)
- Get the
template_slide_idfrom analysis results - POST to this endpoint with your slide data
- Receive
generation_idimmediately (HTTP 202) - Poll
GET /presentations/{generation_id}/statusevery 2-5 seconds - When status is
completed, download fromdownload_url
Table Pagination: If your slide is table-only and auto_paginate_tables
is enabled (default), a large table may generate multiple slides. Check
total_pages_generated in the status response. Slides that combine table and text content
should set auto_paginate_tables to false.
For multiple slides: Use POST /presentations/generate-deck instead.
Authorizations
Body
Request schema for generating a single slide asynchronously.
Use this endpoint for quick single-slide generation. The route returns a generation ID immediately; poll the status endpoint for progress and the final download URL.
Note: If the slide is table-only and auto_paginate_tables is enabled,
a large table may generate multiple pages (check total_pages_generated in
the status response).
Response
Generation started - poll status endpoint for progress
Response schema for async generation requests.
This response is returned immediately when you POST to /presentations/generate
or /presentations/generate-deck, and when you PUT to
/presentations/{id}/update-charts. The actual Aspose work happens in the
background.
Next steps:
- Save the
generation_idfrom this response - Poll
status_url(orGET /presentations/{generation_id}/status) every few seconds - When status becomes
completed,partial, orfailed, generation is done - Download from
download_urlin the status response (forcompletedorpartial)