Versioning
The Korven One API uses URL-major versions with date-based minor pins.
Current version
URL major: v1. Header minor: Korven-Version: 2026-04-01. Requests without the header use the version pinned on your account.
Compatibility policy
- Additive changes (new fields, new enum values) ship without a new version.
- Breaking changes require a new dated version; the previous version is supported for 24 months.
- Deprecations are announced 90 days in advance in the Changelog and by email.
Migrating
Pin the new version in a staging key first, replay production traffic with a shadow reader, then bump the header on the primary key.