> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poesius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference Introduction

> Complete API reference for Poesius REST API and MCP

## 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](/authentication) for details.

<Card title="Authentication Guide" icon="key" href="/authentication">
  Learn how to authenticate
</Card>

## REST API Endpoints

### Presentation Generation

<Card title="Generate from Document" icon="wand-magic-sparkles" href="/api-reference/endpoints/generate-from-doc">
  POST /slides/generate-from-doc
</Card>

<Card title="Presentation Status" icon="circle-check" href="/api-reference/endpoints/presentation-status">
  GET /presentations/{presentation_id}
</Card>

<Card title="Download Presentation" icon="download" href="/api-reference/endpoints/download">
  GET /presentations/{presentation_id}/download
</Card>

### Template Management

Template management endpoints are available. See the [Template Management guide](/api/templates) 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:**

```json theme={null}
{
  "status": "healthy",
  "timestamp": "2024-01-01T12:00:00Z",
  "services": {
    "redis": "connected",
    "database": "connected"
  }
}
```

## MCP Tools

<Card title="List Templates" icon="list" href="/api-reference/mcp/list-templates">
  list\_templates
</Card>

<Card title="Generate Slides" icon="wand-magic" href="/api-reference/mcp/generate-slides">
  generate\_slides
</Card>

<Card title="Generate Content" icon="file-lines" href="/api-reference/mcp/generate-content">
  generate\_presentation\_content
</Card>

<Card title="Slide from Content" icon="diagram-project" href="/api-reference/mcp/slide-from-content">
  slide\_from\_content
</Card>

<Card title="Refine Slide" icon="wand-magic-sparkles" href="/api-reference/mcp/refine-slide">
  refine\_slide
</Card>

## 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`.