OpenAPI

The platform API publishes an OpenAPI 3.1 document describing every /v1 endpoint, its authentication mode, and its request and response schemas.

curl https://api.assistant-billing.dev/v1/openapi.json

The endpoint is public and requires no authentication. Use it to generate typed clients, drive request tooling such as Postman or Bruno, or diff the API surface between releases.

Guarantees

The document is generated from the same endpoint manifest the server is tested against: a drift test asserts that the manifest and the mounted routes match in both directions, so a route cannot ship undocumented and the spec cannot describe a route that does not exist.

Security schemes distinguish the two authentication modes described in Authentication: platform-key bearer endpoints and session-token endpoints. Responses that serialize dynamic records (analytics aggregates, request logs) are modeled as open objects rather than exhaustive schemas.