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

# Cloud API v3

> Authentication, base URL, and the first public v3 API request

The public Cloud API uses the following base URL:

```text theme={null}
https://api.presenton.ai/api/v3
```

Create an API token from your Presenton account and send it as a bearer token:

```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

Generate a presentation synchronously:

```bash theme={null}
curl --request POST \
  --url https://api.presenton.ai/api/v3/presentation/generate \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "Create a concise presentation explaining retrieval-augmented generation",
    "n_slides": 8,
    "language": "English"
  }'
```

Generation can take long enough to exceed a client timeout. Use [asynchronous generation](/cloud/guides/async-generation) for production integrations that need polling and retry control.

## Choose an implementation guide

<CardGroup cols={2}>
  <Card title="Generate a presentation" icon="presentation-screen" href="/cloud/guides/generate-a-presentation">
    Understand inputs, generation controls, responses, exporting, and failure handling.
  </Card>

  <Card title="Generate from documents" icon="file-arrow-up" href="/cloud/guides/generate-from-documents">
    Upload source files and use their returned values during generation.
  </Card>

  <Card title="Generate asynchronously" icon="clock-rotate-left" href="/cloud/guides/async-generation">
    Queue long-running jobs and monitor the task lifecycle safely.
  </Card>

  <Card title="Create from structured JSON" icon="brackets-curly" href="/cloud/guides/create-from-json">
    Fill template layout schemas with application-owned data.
  </Card>

  <Card title="Templates and themes" icon="palette" href="/cloud/guides/templates-and-themes">
    Discover design identifiers and create reusable visual themes.
  </Card>

  <Card title="Receive webhooks" icon="webhook" href="/cloud/guides/webhooks">
    Subscribe to completion and failure events for generated presentations.
  </Card>
</CardGroup>

<Note>
  The reference contains only the supported public v3 surface. Internal Cloud routes are deliberately excluded from the published OpenAPI document.
</Note>