Changelog

/v1 has not shipped its first public release yet, so there is nothing to list here. This page will carry one dated entry per change once it does.

The policy in the meantime

Within /v1, only additive changes ship without notice: a new endpoint, a new optional parameter, a new response field, or a new value in a field already marked x-extensible-enum (a market key, an error code, a plan). Renaming or removing a field, changing its type, or changing what a parameter defaults to never ships inside /v1. That kind of change ships as /v2 instead, with /v1 kept running and both versions documented for a minimum 90-day notice period.

The full policy, including the deprecation-window headers (Deprecation, Sunset) a client should watch for, lives in the repository at odds/api/BREAKING_CHANGES.md and is enforced by the OpenAPI contract tests.