Documentation

Changelog & Versioning

Track API updates, new features, and breaking changes. Stay informed about V2 releases and V1 deprecation timeline.

V1 API Deprecation Notice

Synapse SDK V1 will be sunset on March 31, 2026. Please migrate to V2 before this date. V1 endpoints will continue to work until the sunset date, but all new features are V2-only.

View V1 to V2 Migration Guide →

Changelog Entries

2025-01-15
V2 Release
Latest

Synapse SDK V2 - Major Release

Introducing a complete overhaul of the emotion analysis system with 6 EQ dimensions, trajectory tracking, and advanced conversation features.

Added

  • 6 EQ Dimensions: intensity, valence, arousal, complexity, wonderIndex, discoveryLevel
  • Intensity Levels: critical, high, moderate, subtle, minimal - for granular emotion strength
  • Trajectory Tracking: baseline analysis, trend detection, breakthrough moments
  • Conversation Mode Detection: emotional_support, crisis_intervention, analytical_deep_dive, etc.
  • Growth Tracking: EQ development metrics over time
  • Pattern Detection: temporal, trigger-based, cyclical, sequential, and recovery patterns
  • Belief Detection: identity, value, capability, and relational beliefs from conversation
  • Hostility Detection: safety monitoring with recommended response strategies
  • Batch Analysis API: /v2/emotions/batch-analysis for bulk processing

Changed

  • Endpoint prefix: All V2 endpoints use /v2/ prefix
  • Analysis endpoint: /analyse → /analysis
  • Emotion model: emotion-v1 → emotion-v2
  • Response structure: Enhanced with EQ dimensions, trajectory, and mode detection

Deprecated

  • V1 API: All V1 endpoints deprecated, sunset date: March 31, 2026
  • emotion-v1 model: Use emotion-v2 for new integrations
2024-10-25

Added

  • Batch Emotion Analysis Endpoint (/v1/emotions/batch-analyse)
  • Process multiple messages in a single request for improved throughput
2024-10-02

Added

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

Changed

  • Improved emotion intensity scaling with descriptive levels
2024-09-15

Added

  • Message-level lookup: GET /v1/emotions/:context_id/message/:external_id

Fixed

  • Corrected token usage accounting for analyse_tokens

API Versioning

Current Versions

V2https://api.kaikostudios.xyz/v2- Current, recommended
V1https://api.kaikostudios.xyz/v1- Deprecated, sunset March 31, 2026

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

Deprecation Policy

  • Deprecations announced at least 90 days in advance
  • Deprecation notices appear:
    • In this Changelog
    • In API response headers
    • In the Console dashboard
    • Via email for affected customers

Example deprecation header:

Kaiko-Deprecation: 2026-03-31
Kaiko-Replacement: v2/emotions/analysis

Staying Updated

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