> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agntix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Notable changes to the public Agntix API. We follow Keep a Changelog and Semantic Versioning.

We document every backwards-incompatible change here. Backwards-compatible additions are summarized;
internal-only changes are not.

The published source of truth for breaking-change deprecation timelines is the [API Reference](/api-reference/introduction)
and the `Sunset` HTTP response header.

***

## \[Unreleased]

### Added

* Documentation portal launched at `docs.agntix.ai` with auto-generated API reference from the
  filtered gateway OpenAPI spec.
* New `x-internal: true` OpenAPI extension lets backend owners hide individual endpoints from the
  public docs without touching the gateway filter.

### Changed

* Internal-only routes (`/admin`, `/scheduler`, `/metering`, `/n8n`, `/users`, several voice and
  WhatsApp ingress paths) are now stripped from `/docs/json` at the gateway. They were never
  documented; this just makes the contract explicit.
* The Swagger UI at `/api/v1/docs` (chat-engine) and the Scalar playground at `/api/v1/playground`
  now respond with `X-Robots-Tag: noindex, nofollow`.

### Security

* Documentation page lints for accidentally-exposed secrets (`pk_live_…`, `INTERNAL_SECRET`,
  internal slugs) on every PR.

***

## \[1.4.0] — 2026-04-15

### Added

* `POST /v1/chat/call-campaigns/{id}/pause` and `/resume` for managing in-flight campaigns.
* New `endOfTurnDetection` option `STT_ENDPOINTING` for ultra-low-latency voice flows.

### Changed

* Voice agent `tts.provider` enum expanded to include `cartesia` and `rime`.

### Deprecated

* `POST /api/v1/chat/sessions` (legacy passthrough). Use `POST /v1/chat/chat/sessions` instead.
  Deprecation header set; full removal scheduled for `2.0.0`.

***

## \[1.3.0] — 2026-03-12

### Added

* Server-Sent Events stream at `GET /v1/chat/events/stream` for real-time UI updates.
* Knowledge store rerank toggle (`config.rerank.enabled`).

### Fixed

* Tool calls with binary response bodies no longer crash the session.

***

## \[1.2.0] — 2026-02-04

### Added

* WhatsApp business agents — wire any agent to a Twilio WhatsApp number from the dashboard.
* Per-key scopes on API keys (`chat:read`, `chat:write`, `voice:write`, …).

### Changed

* The default `topK` for RAG retrieval increased from 1 to 2.

***

## Versioning policy

* **MAJOR** (`2.0.0`) — breaking changes; minimum 6-month deprecation window.
* **MINOR** (`1.5.0`) — additive features; existing endpoints unchanged.
* **PATCH** (`1.4.1`) — bug fixes only.

Subscribe to [`subscription.updated`](/webhooks/events) and watch the `Sunset` response header to
detect deprecations programmatically.