API.md

HTTP API

The complete openGym HTTP API — every route of api/server.js, with auth, request/response schemas and the env-dependent behavior — is documented as a hand-written OpenAPI 3.1 spec:

• Spec (source of truth): api/openapi.yaml
• Browsable (Swagger UI): https://opengym.duarte-santos.ch/api.html

Lint it after changing routes:

npx --yes @redocly/cli lint api/openapi.yaml