> 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/changelog.md).

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