Skip to navigation

Versioning and changelog

View as Markdown

The Public API is header-versioned. Send Trutee-Version: 2026-07-29; missing or unsupported values return 400.

Within a dated version, clients must tolerate additive response fields, new enum and error-code values, new endpoints, new optional parameters, relaxed validation, opaque-ID format changes, and JSON key reordering.

A new dated version is required to remove or rename a field, change a field’s type or meaning, remove an enum value, make optional input required, tighten validation, change a default, or otherwise invalidate a previously successful conforming request or interpretation.

2026-07-29

  • Added opaque /courses discovery and bounded /availability.
  • Added atomic single- and multi-Tee-Time POST /reservations.
  • Added Reservation list, retrieve, reconciliation watermarks, and policy-aware cancellation.
  • Established OAuth selected-organization isolation and exact API-enabled-role capabilities.
  • Established Pay at Course only, integration-owned messaging, cancel-and-rebook changes, no Reservation Holds, and deferred webhooks.
  • Standardized the pre-integration public vocabulary on external_reference_id, integration_attribution, the expanded access tier, and neutral Reservation operation/type names. Internal authorization roles are not part of the public contract.
  • Extended availability offer lifetime from two minutes to five minutes.

This repository configures the production Fern instance at docs.trutee.app. A merged documentation change is publishable by the production workflow; a source change is not a claim that the public site has already published it.