there are several API documentation generation tools, in some cases leveraging the OpenAPI specification.
this issue is to explore the application of such a tool here because the manually maintained Markdown file of API commands will not scale from the rerobots perspective and is difficult to read from the user's perspective.