Documentation

Changelog & Versioning

Kaiko APIs evolve over time to add new features, models, and improvements. This page explains how we handle versions, deprecations, and changelog entries so you can stay up-to-date with minimal disruption.

1. API Versioning

Current Version

https://api.kaiko.ai/v1
  • • Major version (v1) is part of the URL.
  • • All breaking changes require a new major version (v2, v3, ...).
  • • Minor, non-breaking improvements roll out under the same version.

Breaking Changes (require new version)

  • • Removing or renaming fields.
  • • Changing default parameter behavior.
  • • Modifying response formats in incompatible ways.

Non-Breaking Changes (stay in current version)

  • • Adding new optional fields.
  • • Adding new endpoints.
  • • Expanding enum values.
  • • Performance improvements.

2. Deprecation Policy

  • • We announce deprecations at least 90 days in advance.
  • • Deprecation notices appear:
    • ○ In the Changelog
    • ○ In API response headers (Kaiko-Deprecation: <date>)
    • ○ In the Console (for affected customers)

Example header:

Kaiko-Deprecation: 2025-12-01
Kaiko-Replacement: v2/chat/completions

3. Changelog Format

Each entry includes:

  • • Date (YYYY-MM-DD)
  • • Type: Added, Changed, Deprecated, Fixed, Removed
  • • Details: What changed and why
  • • Migration Notes (if needed)

4. Example Changelog Entries

2025-10-02
Latest

Added

  • • Unified Chat API (/v1/chat/completions) now supports tools field for function calling.
  • • New error code: duplicate_id (409 Conflict).

Changed

  • • Improved emotion intensity scaling for text field (Slightly, Moderate, Highly).
2025-09-15

Added

  • • Context-Based Emotion API:
    • ○ GET /v1/emotions/:context_id/message/:external_id to fetch message-level analysis.

Fixed

  • • Corrected token usage accounting for analyse_tokens.
2025-09-01

Deprecated

  • • Legacy emotion_odel field typo in Chat API request. Please use emotion_model.
    • ○ Deprecation sunset: 2025-12-01
    • ○ Calls using emotion_odel will fail after this date.

5. Release Cadence

  • • Weekly: Bugfixes, small non-breaking improvements.
  • • Monthly: New features and models.
  • • Quarterly: Major product announcements, possible new versions.

6. Staying Updated

  • • Docs: developers.kaiko.ai (always current)
  • • RSS Feed / Email: Subscribe for changelog updates.
  • • Status Page: status.kaiko.ai for live incidents.
  • • Community: Join our Discord/Forum for release discussions.

COMING SOON