# Versioning The major version is in the address: `https://kelki.ai/api/v1`. Within a version, changes are additions only. ## What may change in v1 - New fields in responses, new routes, new error codes. - New values of an enumeration documented as extensible. Your code must ignore unknown fields and handle an unknown error code according to its HTTP status. ## Breaking change - It opens a new version (`/v2`); today, `/v2…` returns `404 not_found`. - `/v1` stays served at least 12 months after the announcement. - The announcement goes through the [changelog](https://kelki.ai/developers/en/changelog/) and the `Deprecation` (RFC 9745) and `Sunset` (RFC 8594) headers on the responses concerned. ## Knowing which version answers Every response carries `Kelki-Api-Version: 1` and the revision date. Webhook events carry `api_version`. ## About this page - URL : https://kelki.ai/developers/en/versioning/ - Language : en - fr : https://kelki.ai/developers/fr/versioning/ - en : https://kelki.ai/developers/en/versioning/ - x-default : https://kelki.ai/developers/ - Portal : https://kelki.ai/developers/llms.txt