OpenAPI & endpoint reference
The endpoint reference is generated from the application’s Public API v1 registry and runtime schemas. It is the source of truth for paths, parameters, request bodies, responses, and schemas.
OpenAPI document
The document is available without a PAT so tooling can discover the public contract. The resource endpoints described by that document still require the authentication and scopes defined in the contract.
Keep conceptual guidance and the contract separate
The pages in this section explain the behavior that is easy to miss when reading a schema:
Do not copy the OpenAPI document into this repository as a second manually maintained file. When the runtime contract changes, update the generated registry and add the corresponding user-facing explanation under docs/api/.