API Reference

Base URL#

http://localhost:8011/api/v1

All endpoints require Bearer token authentication in the Authorization header.

Presentations#

Generate Presentation#

Generate a complete presentation from a natural language prompt.

Request Body:

{
  "prompt": "Government AI adoption strategy for 2025",
  "template_id": "tmpl-a1b2c3",
  "slide_count": 10,
  "language": "en"
}

Response:

{
  "pres_id": "pres-a1b2c3",
  "title": "Government AI Adoption Strategy 2025",
  "prompt": "Government AI adoption strategy for 2025",
  "status": "completed",
  "slide_count": 10,
  "template_id": "tmpl-a1b2c3",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:05Z"
}

List Presentations#

Returns all presentations with their status and metadata.

Get Presentation#

Returns full presentation details.

Delete Presentation#

Permanently delete a presentation and its associated data.

Slide Editing#

Edit Slide#

Apply a natural language editing instruction to a specific slide. The slide_idx parameter is zero-indexed.

Request Body:

{
  "instruction": "Add a comparison table showing Q3 vs Q4 performance metrics"
}

Export#

Export PPTX#

Export the presentation as a PowerPoint file. Returns a binary PPTX file download.

Export PDF#

Export the presentation as a PDF document. Returns a binary PDF file download.

Templates#

Upload Template#

Upload a PPTX file as a reusable template. Accepts multipart/form-data.

Form Fields:

Response:

{
  "template_id": "tmpl-a1b2c3",
  "name": "Ministry Branded Template",
  "description": "Official template with ministry branding",
  "created_at": "2024-01-15T10:30:00Z"
}

List Templates#

Returns all available templates.

Comments#

Create Comment#

Add a review comment to a specific slide.

Request Body:

{
  "slide_index": 3,
  "element_id": "",
  "text": "Please update the budget figures",
  "author": "Ahmed Al Mansoori"
}

List Comments#

Returns all comments for a presentation, optionally filtered by slide.

Query Parameters:

Health#

Health Check#

Returns service health status.

Metrics#

Returns service metrics including uptime and request counts.