ADR-018: OpenAPI-first API contracts
Context
5 docs tagged with "api"
View all tagsADR-020: Domain boundary contracts — three tiers (rest / grpc / internal), structure, naming & layering
Substantially revised 2026-06-20: adds the by-domain folder layout, the three-tier contract model, interface/adapter naming, the service+adapters layering, the error model, and principal handling.
ADR-021: API URL scheme, versioning & gateway authentication
Companion to ADR-020 (which covers the contract tiers, structure, naming, and layering).
API internals reference
Auto-generated code reference for internal APIs
How to add an API endpoint
End-to-end guide from Protobuf schema to Kotlin handler to TypeScript client