> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.trutee.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trutee.app/_mcp/server.

# Versioning and changelog

> Dated contracts, compatibility promises, and current v1 scope.

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.