Introduction to Prezent Platform API

Welcome to the Prezent Platform API documentation. This documentation provides comprehensive information about our API endpoints, authentication methods, and usage examples for automating presentation generation and user management.

Getting Started

To use the Prezent Platform API, you'll need:

1. An API key for authentication
2. Basic understanding of REST APIs
3. A tool to make HTTP requests (like cURL, Postman, or your preferred programming language)

Authentication

All API endpoints require authentication using a Bearer token. Include your API key in the Authorization header with each request:

curl -H "Authorization: Bearer your-api-key" https://api.prezent.ai/endpoint

Available APIs

Our platform provides three main APIs for different functionalities:

1. Auto Generator API - Create and manage presentation generation jobs

   • Generate presentations from prompts and templates
   • Check generation status and download results
   • List presentation themes and audiences
   • Upload files for context

2. Template Converter API - Convert and transform presentation templates

   • Convert templates between different formats (pptx, pdf, html, json)
   • Transform templates to match brand guidelines
   • Batch process multiple template conversions
   • Track conversion status and download results

3. SCIM User Management API - Manage and provision users using industry-standard SCIM

   • Create, read, update, and delete users
   • Filter and search user data
   • Automate user lifecycle management

Quick Example

Here's a quick example of generating a presentation:

cURL

curl -X POST https://api.prezent.ai/api/v1/autogenerator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Generate a presentation on AI trends",
    "template_id": "your-template-id"
  }'

Node.js

const axios = require('axios');

const generatePresentation = async () => {
  try {
    const response = await axios.post('https://api.prezent.ai/api/v1/autogenerator', {
      prompt: 'Generate a presentation on AI trends',
      template_id: 'your-template-id'
    }, {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    });
    
    console.log('Response:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

generatePresentation();

Python

import requests
import json

def generate_presentation():
    url = 'https://api.prezent.ai/api/v1/autogenerator'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
    payload = {
        'prompt': 'Generate a presentation on AI trends',
        'template_id': 'your-template-id'
    }
    
    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status()
        print('Response:', response.json())
        return response.json()
    except requests.exceptions.RequestException as e:
        print('Error:', e)
        if hasattr(e, 'response') and e.response is not None:
            print('Response:', e.response.json())

generate_presentation()

Here's a quick example of getting available templates for conversion:

cURL

curl -X GET https://api.prezent.ai/api/v1/template-converter/templates \
  -H "Authorization: Bearer YOUR_API_KEY"

Node.js

const axios = require('axios');

const getTemplates = async () => {
  try {
    const response = await axios.get('https://api.prezent.ai/api/v1/template-converter/templates', {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    });
    
    console.log('Response:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

getTemplates();

Python

import requests

def get_templates():
    url = 'https://api.prezent.ai/api/v1/template-converter/templates'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY'
    }
    
    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        print('Response:', response.json())
        return response.json()
    except requests.exceptions.RequestException as e:
        print('Error:', e)
        if hasattr(e, 'response') and e.response is not None:
            print('Response:', e.response.json())

get_templates()

Need Help?

If you need assistance or have questions about using our API:

1. Check the detailed API reference documentation for each endpoint
2. Review the Getting Started guide for authentication details
3. Contact our support team
4. Visit our community forums

Next Steps

• Read the Getting Started guide for authentication setup
• Explore the Auto Generator API for presentation generation
• Explore the Template Converter API for template conversion
• Learn about our SCIM User Management API for user provisioning
• Review our best practices and examples in each API section