Skip to main content

​
🎯 Endpoint

POST /api/v1/ppt/presentation/generate/async
Use this endpoint to schedule presentation generation.
It immediately returns a Task ID which you can later use to check status and download the presentation.
For detailed information about the request format, please see the API Reference.

​
🔐 Authentication

Before calling the API, log in to Presenton and create an API key from your account page: Presenton Account.
Your key will look like sk-presenton-xxxxx. Include this key in every request using the Authorization header: 
Authorization: Bearer sk-presenton-xxxxx

​
📤 Example Request

curl -X POST https://api.presenton.ai/api/v1/ppt/presentation/generate/async \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-presenton-xxxxx" \
  -d '{
    "content": "Introduction to Machine Learning",
    "n_slides": 5,
    "language": "English",
    "template": "general",
    "export_as": "pptx"
  }'

​
📥 Example Response (Task Creation)

{
  "id": "task-9a827c13f4",
  "status": "pending",
  "message": "Presentation generation task created",
  "created_at": "2025-09-14T08:00:00Z",
  "updated_at": "2025-09-14T08:00:00Z",
  "data": {}
}
  • id: The unique Task ID (use this to check status)
  • status: Current state of the task (pending, processing, completed, failed)
  • message: Human-readable status message
  • created_at / updated_at: Timestamps
It gives error regarding credits and other things immediately on this request itself. Check API reference of asynchronous generation for more details on options.

​
🔄 Checking Task Status

Use the following endpoint to then check the status of your async task: 
GET /api/v1/ppt/presentation/status/{id}
Replace {id} with the Task ID returned earlier.
Once the task is completed, the response will include the presentation file path and editor link.

​
Example Status Check

curl -X GET https://api.presenton.ai/api/v1/ppt/presentation/status/task-9a827c13f4 \
  -H "Authorization: Bearer sk-presenton-xxxxx"

​
✅ Example Completed Response

{
  "id": "task-9a827c13f4",
  "status": "completed",
  "message": "Presentation generated successfully",
  "created_at": "2025-09-14T08:00:00Z",
  "updated_at": "2025-09-14T08:01:30Z",
  "data": {
    "presentation_id": "d3000f96-096c-4768-b67b-e99aed029b57",
    "path": "https://api.presenton.ai/static/user_data/d3000f96-096c-4768-b67b-e99aed029b57/Introduction_to_Machine_Learning.pptx",
    "edit_path": "https://presenton.ai/presentation?id=d3000f96-096c-4768-b67b-e99aed029b57",
    "credits_consumed": 5
  }
}
Check API Reference of status check for more details.