OpenAPI

The gateway serves an OpenAPI 3.1 document at:

GET https://api.rolchat.com/openapi.json

It is assembled at gateway start-up from the documents each service contributes: paths and schemas are merged, duplicates are namespaced by service, and any path marked internal (mesh-only) is removed. Contributions are added service by service; families that have not contributed yet appear in the endpoint reference but not in the document. Until the document covers the whole surface, treat the endpoint reference as the authoritative list of families and the conventions page as the authoritative contract.

Every RolChat contract, in the document or not, follows the conventions: the envelope, cursor pagination, idempotency keys, rate-limit headers and the error codes.