Getting started
Creating developer account
Getting your API key
General Use
Brand Themes
Generate Presentation APIs
Get all themes
Transform Document
Presentation Status
Preview and Export APIs
Get Presentation
Export Presentation
This document describes the resources to effectively utilise Revent Presentations API.
If you have any problems or requests, please contact our Support team at support@revent.ai.
To access the Revent Presentations API, login as a developer.
Once your account has been registered for the API, visit 'Developers Hub'. Click "Generate API Key" to generate your API Key.
Initially, you will have 3 tokens already added in your account. This is perfect for trying out the API.
If ready to move to production mode, check 'API Pricing' and purchase tokens as per your requirement. For larger requirements, connect with us.
Revent Presentations API makes it easy to convert raw data into fully branded presentations. Start by generating a brand theme using a logo or website URL. This is a one-time setup for each client. Once created, the theme can be reused for all future presentation exports.
Our API even lets you offer multiple theme options per brand to ensure uniqueness and creative alignment before finalising on one.
If a client prefers to use an existing brand template instead, a request can be submitted to our support team.
To transform a presentation, all you need is the source file and a themeId. Additional parameters let you further customize the output. Presentation slides can be previewed as images or downloaded as PPTX or PDF files.
Revent Presentations API includes a wide range of professional themes for general use. If you need to transform data into a presentation without client-specific branding, simply choose from any of our open themes.
Each theme comes with sample slides to preview and select. Our library is constantly growing, so check back regularly for new options.
For custom themes with client-specific branding, use Revent Press to generate branded themes by uploading logos or website URLs, and providing brand details like fonts and colors. Choose from a variety of automatically generated design options, and use the associated themeId for all future API calls.
You can also integrate existing brand themes directly into Revent Press. This is a manual process, reach out to our team to get started.
https://api.revent.ai/core/v1/theme/get-all-themes
Retrieves available theme options for converting documents into presentations.
Next Steps: Use the themeId in a transform request to generate a presentation with the selected theme. Refer to theme demos for sample output visuals.
X-API-KEY: YOUR_API_KEY
curl --location 'https://api.revent.ai/core/v1/theme/get-all-themes' \ --header 'X-API-KEY: YOUR_API_KEY'
[
{
"code": 0,
"message": "SUCCESS",
"themeId": 17,
"themeName": "Marsala",
"thumbnailUrl": "https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx_1.png",
"themeColor": [
"#964f4c"
],
"publicTheme": true,
"margin": 80,
"fontFamily": "Montserrat",
"darkTheme": false,
"themeTags": [
"Business",
"Report",
"Corporate",
"Maroon",
"Red",
"Minimalistic",
"Professional",
"Work"
],
"themeDemo": [
"https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx/100_Marsala_Theme_v1.1.png",
"https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx/100_Marsala_Theme_v1.2.png",
"https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx/100_Marsala_Theme_v1.3.png",
"https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx/100_Marsala_Theme_v1.4.png",
"https://cdn1.revent.ai/thumbnails/100_Marsala_Theme_v1.pptx/100_Marsala_Theme_v1.5.png"
],
"status": false
}
]https://api.revent.ai/core/v1/ppt/transform
Initiates the transformation of a document into a presentation by uploading a .docx or .pptx file along with the themeId.
Next Steps: Use the presentationId from the response to check the transformation status and download the final export.
Credits: One credit is deducted for each successful transformation.
X-API-KEY: YOUR_API_KEY
themeId: 1
file: (binary file)
| Parameter | Description |
|---|---|
| objective | Specify a one-word objective (e.g., REPORT, PITCH, GUIDE) |
| style | Choose a preset design style: FORMAL, MINIMAL, CREATIVE, CURVY, SHARP, ILLUSTRATIVE |
| slideCountIndication | Define desired slide count as range (e.g., 3–7, 15–20) |
| language | Set output language (Latin alphabet languages: ENGLISH, SPANISH, FRENCH) |
| imagePreference | Include/exclude stock images: STOCK, NONE |
curl --location 'https://api.revent.ai/core/v1/transform' \ --header 'X-API-KEY: YOUR_API_KEY' \ --form 'themeId="1"' \ --form 'file=@"/path/to/file"' \ --form 'objective="REPORT"' \ --form 'style="FORMAL"' \ --form 'slideCountIndication="5-10"' \ --form 'language="ENGLISH"' \ --form 'imagePreference="STOCK"'
{
"code": 0,
"message": "Document accepted",
"data": {
"presentationId": 5480,
"themeId": 2,
"transformRequestId": 1253,
"transactionId": "9ec8cdd5-694c-466e-a3d0-624cb01f252f",
"requestStatus": "PENDING",
"errorMessage": null
}
}https://api.revent.ai/core/v1/transform-status/{presentationId}
Checks the completion status of a transformation request. Insert the presentationId in the endpoint to view the progress.
X-API-KEY: YOUR_API_KEY
All Completed
Presentation is ready for preview or download
Any Pending
Recheck the status shortly
Any Failed
Retry the document transformation
curl --location -g 'https://api.revent.ai/core/v1/transform-status/{presentationId}' \
--header 'X-API-KEY: YOUR_API_KEY'[
{
"presentationId": 5480,
"transactionId": "9ec8cdd5-694c-466e-a3d0-624cb01f252f",
"slideNumber": 1,
"processingState": "COMPLETED"
},
{
"presentationId": 5480,
"transactionId": "9ec8cdd5-694c-466e-a3d0-624cb01f252f",
"slideNumber": 2,
"processingState": "COMPLETED"
}
]https://api.revent.ai/core/v1/get-presentation/{presentationId}
Retrieves presentation details including slide information and thumbnails for preview purposes.
Next Steps: Use slide thumbnails for preview purposes before exporting the final presentation.
X-API-KEY: YOUR_API_KEY
curl --location -g 'https://api.revent.ai/core/v1/get-presentation/{presentationId}' \
--header 'X-API-KEY: YOUR_API_KEY'{
"code": 0,
"message": "SUCCESS",
"presentationId": 5480,
"uuid": "1e20d56e-ae82-4a95-afd9-bfd209916288",
"name": "The Importance of Concise Communication",
"slides": [
{
"slideId": 25399,
"slideNumber": 1,
"confirmed": false,
"variants": [
{
"slideVariantId": 86780,
"thumbnailUrl": "https://cdn2.revent.ai/thumbnails/SV-ddd8793f-7b0a-4bea-ad0d-42dd45d83211-10382118906911938897_5.png",
"active": true,
"enhancedWithAI": false,
"style": "Style_Cover_20"
}
]
}
],
"lastModifiedBy": "1101",
"lastModifiedDate": "2025-07-25T07:46:34.136213487Z",
"themeId": 2,
"readyToView": true,
"creationMethod": "TRANSFORMED",
"transformStatus": "COMPLETED",
"createdDate": "2025-07-25T07:38:35.831684Z"
}https://api.revent.ai/core/v1/download-presentation?presentationId={presentationId}&format={format}
Downloads the generated presentation using the presentationId and specifies the desired export format.
Credits: One credit is deducted for exporting a given presentationId only once.
Acceptable formats: pptx, pdf
Note: The response is a binary Blob (application/vnd.openxmlformats-officedocument.presentationml.presentation or application/pdf). To handle it, save the response as a file using the appropriate extension (e.g., .pptx or .pdf) based on the `format` parameter. Example (in JS): fetch → blob() → URL.createObjectURL(blob) → trigger download via anchor tag or FileSaver.js.
X-API-KEY: YOUR_API_KEY
presentationId: {presentationId}
format: {format}
curl --location -g 'https://api.revent.ai/core/v1/download-presentation?presentationId={presentationId}&format={format}' \
--header 'X-API-KEY: YOUR_API_KEY'We're always looking for ways to improve our APIs. If you have any suggestions to make our APIs more effective, reach out to us on support@revent.ai