> For the complete documentation index, see [llms.txt](https://docs.perceptis.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perceptis.ai/perceptis-api-v1/templates.md).

# Templates

Use `template_name` to generate with a template your organization can access. If you omit it, Perceptis chooses the same default template experience used in the app.

## Choose a template

In `POST /api/v1/generate` you may set:

```json
"template_name": "Acme Executive"
```

Template names match the templates available to your organization in Perceptis. Use the same display name your team uses in the product.

## Use automatic template selection

If you omit `template_name`, Perceptis uses your organization's default template when one is configured. If no organization default is available, Perceptis uses another template available to your organization. If no template is available, generation still runs with a plain PowerPoint output.

## Ambiguous names

If a name matches more than one accessible template, the API returns `409` with error code `ambiguous_template_name`. Rename one of the templates or choose a unique template name before retrying.

## Practical tips

* Keep template names stable for production integrations.
* Prefer a small set of approved templates for automated generation.
* Treat template names as case-sensitive unless your Perceptis team tells you otherwise.
