Templates

Template selection by name and automatic defaults.

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:

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