Versioning and changes

Versioning and change guidance for Perceptis API v1.

The Perceptis API uses versioned paths. The current generation API is under:

/api/v1/

Use the versioned paths shown in this documentation for production integrations.

Non-breaking changes

Perceptis may add optional fields, response metadata, or additional error codes within v1. Build clients to ignore unknown fields they do not need.

Breaking changes

Breaking changes are introduced with a new API version. Check this page when planning upgrades or reviewing integration behavior.

Changes

2026-08 — Deck jobs may complete with fewer slides than requested

A deck job now completes when at least one slide is produced. Before this change, a deck job failed if any slide failed.

What changes for your integration:

• status is completed when the deck holds one or more slides. The downloaded .pptx contains the slides that were produced.

• downloads[0].slide_count is the number of slides in the file. Read the slide count from this field, not from your prompt.

• status is failed only when no slide was produced. A failed job is not charged.

• You are charged for the slides in the file, and for no others.

This change is additive: no field is added, removed or renamed, and no existing field changes type. A client that reads slide_count needs no change.