API Versions
The Akhara API is versioned via the URL path. The current version isv1.
Stability Guarantees
Stable Endpoints
Endpoints marked as stable will not have breaking changes within a major version:- Request/response fields will not be removed
- Required parameters will not be added
- Field types will not change
Beta Endpoints
Some endpoints are marked as beta and may change:Deprecation Policy
When deprecating features:- 6 months notice before removal
- Deprecation header in responses:
X-Akhara-Deprecated: true - Migration guide in documentation
- Email notification to affected users