📦 API Versioning

Our versioning strategy ensures stability for your applications while allowing us to continuously improve the API.

Version History

2025-01-01 Current
Released January 1, 2025
Added extended thinking, PDF support, improved tool use. Recommended for all new integrations.
2024-06-01 Deprecated
Released June 1, 2024 • Deprecated January 1, 2025
Added vision capabilities, streaming improvements. Will be retired July 1, 2025.
2024-01-01 Retired
Released January 1, 2024 • Retired January 1, 2025
Initial stable API release. No longer available for new requests.

Versioning Strategy

📅
Date-Based Versions
Versions are named by release date (YYYY-MM-DD) for clarity
🛡️
6-Month Support
Each version supported for at least 6 months after deprecation
📢
Advance Notice
3+ months notice before any breaking changes or retirements

Setting API Version

Header Example Value Description
mythicdot-version 2025-01-01 Specify exact API version for your requests
mythicdot-beta extended-thinking-2025-01 Opt-in to beta features (may change)

Code Example

Python - Set API Version
from mythicdot import MythicDot # Pin to specific version for stability client = MythicDot( default_headers={ "mythicdot-version": "2025-01-01" } ) # Or set per-request response = client.messages.create( model="mythic-4", max_tokens=256, messages=[{"role": "user", "content": "Hello"}], extra_headers={ "mythicdot-version": "2025-01-01" } ) # Enable beta feature response = client.messages.create( model="mythic-4", max_tokens=256, messages=[{"role": "user", "content": "Hello"}], extra_headers={ "mythicdot-beta": "new-feature-2025-02" } )

Migration Guide

🔄 Migrating to 2025-01-01

1
Update SDK

Update to the latest SDK version which defaults to the new API version.

2
Test in Development

Run your test suite against the new version to identify any breaking changes.

3
Update Headers

Change your version header from "2024-06-01" to "2025-01-01" in production.

4
Monitor

Watch for any unexpected behavior and check deprecation warnings in responses.

Stay Updated

Subscribe to our changelog for the latest API updates.

View Changelog → API Reference