Skip to main content
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 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 and watch the Sunset response header to detect deprecations programmatically.