SDKs & developer tools
OpenAPI and API reference
Maintain a machine-readable contract for generated clients and developer tooling.
Single source of truth
Route schemas, examples, authentication and error objects should map to the public OpenAPI contract.
Versioning
Breaking changes require a new API version or a compatibility plan.