Docs / Versioning

Versioning

New endpoints also accept a TEO-API-Version: 2026-07-01 header for version pinning.

Default behavior

When no version header is supplied, the API serves the latest stable. Breaking changes are announced at least 90 days in advance on the changelog.

Pinning

Pin to a specific date for a known-good response shape. New routes added after that date are still accessible unless the route is also version-gated.

TEO-API-Version: 2026-07-01

Deprecation

Deprecated endpoints return a Sunset header and a Deprecation header pointing to the changelog entry. The endpoint keeps working for the deprecation window (minimum 90 days).