Skip to main content

Versioning

When backwards-incompatible changes are made to the API, we release a new, dated version. For example, the API version 2024-01-05 was released on Fri, 5 Jan 2024. In addition, for major changes, the base url path would be updated, for instance /v2/ instead of /v1/.

You can configure your API version with the Karla-Version header. As a precaution, use API versioning to test a new API version before committing to an upgrade.

Versioning
curl --header "Karla-Version: 2024-01-05" https://api.gokarla.io/

Requests without the Karla-Version header, or with a wrong version will default to use the latest stable version.