> ## 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 | HTTP Basic when instance authentication is configured |
    | 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="/archive/v0.9.0-beta/user-guide/api-and-automation/quickstart">
    Generate a small presentation with the minimum request.
  </Card>

  <Card title="Choose sync or async" icon="clock" href="/archive/v0.9.0-beta/api-guides/presentation-generation-flows">
    Select the right execution mode and understand its lifecycle.
  </Card>

  <Card title="Upload source content" icon="file-arrow-up" href="/archive/v0.9.0-beta/user-guide/api-and-automation/files-and-content">
    Upload documents and images before generation.
  </Card>

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

## Reference conventions

Endpoint pages are generated from curated OpenAPI contracts and contain the authoritative parameters, constraints, request examples, responses, and interactive playground. Conceptual guides explain when and why to use those operations, then navigation takes you directly to the matching Cloud or Self-hosted endpoint.