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

# Generate a presentation with the Cloud API

> Create and verify your first presentation through the public v3 API.

Use this tutorial when a script, product, or internal workflow should create the presentation.

## 1. Create an API token

Create a token in your Presenton account and store it in a secret manager. Do not place it directly in source control.

## 2. Send a request

Replace `YOUR_API_TOKEN`, then run:

```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 six-slide presentation explaining practical customer discovery for early-stage product teams",
    "n_slides": 6,
    "language": "English"
  }'
```

## 3. Save the response

Store the returned presentation identifier and paths. Your application will need them to open, track, or export the presentation.

## 4. Verify the deck

Open the returned edit path in the dashboard. Check the outline, slide order, facts, and visual result before adding the workflow to production.

## 5. Make the integration reliable

* Use [asynchronous generation](/cloud/guides/async-generation) when the caller should not wait on one connection.
* Set a client timeout appropriate for presentation generation.
* Store identifiers so failed handoffs can be retried safely.
* Validate user input and uploaded files before submitting them.
* Treat the API schema as the contract and avoid internal routes.

<Check>
  Your request returns a presentation that can be opened and edited in Presenton Cloud.
</Check>