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

# Presenton API

> Generate, manage, and automate presentations with Presenton Cloud or a self-hosted instance.

Presenton exposes task-oriented REST APIs for presentation generation, files and images, stored presentations, asynchronous work, and webhooks. The documentation publishes only supported integration routes; browser-only and internal backend routes are excluded.

## Choose your API

<Tabs>
  <Tab title="Cloud">
    | Setting        | Value                             |
    | -------------- | --------------------------------- |
    | Version        | v3                                |
    | Base URL       | `https://api.presenton.ai/api/v3` |
    | Authentication | `Authorization: Bearer <token>`   |
    | Infrastructure | Managed by Presenton              |

    Choose Cloud when you want managed infrastructure, account-scoped assets, and Cloud templates or Smart Designs.
  </Tab>

  <Tab title="Self-hosted">
    | Setting        | Value                             |
    | -------------- | --------------------------------- |
    | Version        | v1                                |
    | Base URL       | `https://<your-host>/api/v1`      |
    | Local default  | `http://localhost:5001/api/v1`    |
    | Authentication | Admin-generated Presenton API key |
    | Infrastructure | Operated by you                   |

    Choose self-hosted when integrations must use your network, storage, providers, or modified application source.
  </Tab>
</Tabs>

<Warning>
  Cloud v3 and self-hosted v1 identifiers, credentials, paths, and request schemas are not interchangeable. Always use the reference for the deployment that owns the resource.
</Warning>

## Start with a workflow

<CardGroup cols={2}>
  <Card title="Make the first request" icon="rocket" href="/user-guide/api-and-automation/quickstart">
    Generate a small presentation with the minimum request.
  </Card>

  <Card title="Plan a generation workflow" icon="route" href="/api-guides/presentation-generation-flows">
    Choose a deployment, input path, design source, and delivery mode.
  </Card>

  <Card title="Configure authentication" icon="key" href="/user-guide/api-and-automation/authentication">
    Prepare Cloud bearer tokens or self-hosted API keys.
  </Card>

  <Card title="Upload source content" icon="file-arrow-up" href="/user-guide/api-and-automation/files-and-content">
    Connect documents, uploaded images, and generation requests.
  </Card>

  <Card title="Manage presentations" icon="presentation-screen" href="/user-guide/api-and-automation/presentations">
    Retrieve, edit, derive, list, delete, and export stored decks.
  </Card>

  <Card title="Run background jobs" icon="webhook" href="/user-guide/api-and-automation/async-and-webhooks">
    Combine asynchronous generation, status polling, and webhooks.
  </Card>

  <Card title="Handle responses and errors" icon="triangle-exclamation" href="/user-guide/api-and-automation/errors">
    Build reliable validation, retry, and failure handling.
  </Card>

  <Card title="Open Source tutorial" icon="terminal" href="/user-guide/api-and-automation/open-source-api-tutorial">
    Build one complete self-hosted request from setup to review.
  </Card>
</CardGroup>

## Find the matching API reference

The guides explain sequence, ownership, and operational decisions. Endpoint references contain the authoritative request fields, validation rules, response schemas, and try-it console.

| Task                        | Cloud v3 reference                                                                               | Open Source v1 reference                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| Generate a presentation     | [Synchronous generation](/api-reference/v3-presentation/generate-a-presentation-synchronously)   | [Synchronous generation](/api-reference/presentation/generate-a-presentation-synchronously)   |
| Upload source files         | [Upload source files](/api-reference/v3-files/upload-source-files)                               | [Upload source files](/api-reference/files/upload-source-files)                               |
| Work asynchronously         | [Generate asynchronously](/api-reference/v3-presentation/generate-a-presentation-asynchronously) | [Generate asynchronously](/api-reference/presentation/generate-a-presentation-asynchronously) |
| Check task status           | [Get task status](/api-reference/v3-async-task/get-task-status)                                  | [Get generation status](/api-reference/presentation/get-generation-status)                    |
| Manage stored presentations | [List presentations](/api-reference/v3-presentation/list-presentations)                          | [List presentations](/api-reference/presentation/list-presentations)                          |
| Receive events              | [Subscribe a webhook](/api-reference/v3-webhook/subscribe-a-webhook)                             | [Subscribe a webhook](/api-reference/webhook/subscribe-a-webhook)                             |

## Keep responsibilities separate

* Use a **guide** to choose the correct workflow and call order.
* Use the **API reference** to build and test the exact request.
* Use **hosting documentation** to configure a self-hosted instance, providers, storage, authentication, and networking.
* Use **user guides** to prepare templates or review output in the Presenton application.