Skip to main content

​
Overview

The Poesius API provides two interfaces:
  • REST API: Traditional HTTP REST endpoints
  • MCP (Model Context Protocol): Protocol-based interface for AI assistants

​
Base URL

https://poe.poesius.com/api/v1

​
Authentication

All API endpoints require authentication. See the authentication guide for details.

Authentication Guide

Learn how to authenticate

​
REST API Endpoints

​
Presentation Generation

Generate from Document

POST /slides/generate-from-doc

Presentation Status

GET /presentations/

Download Presentation

GET /presentations//download

​
Template Management

Template management endpoints are available. See the Template Management guide for details:
  • POST /templates/ - Upload template
  • GET /templates/ - List templates
  • GET /templates/{template_id} - Get template details
  • GET /templates/{template_id}/download - Download template
  • PATCH /templates/{template_id} - Update template
  • DELETE /templates/{template_id} - Delete template
  • POST /templates/{template_id}/set-default - Set default template
  • GET /templates/default - Get default template

​
Health Check

Endpoint: GET /health Check system health and connectivity. Response: 
{
  "status": "healthy",
  "timestamp": "2024-01-01T12:00:00Z",
  "services": {
    "redis": "connected",
    "database": "connected"
  }
}

​
MCP Tools

List Templates

list_templates

Generate Slides

generate_slides

Generate Content

generate_presentation_content

Slide from Content

slide_from_content

Refine Slide

refine_slide

​
Response Format

API responses are returned in JSON format. Error responses include an error field with details.

​
Rate Limits

Rate limits apply to all API endpoints. Check your account limits in the web app.

​
Support

For API support, contact us through the web app at https://app.poesius.com.