Posting this as a potential community driven project.
The development team are using the OpenAPI/Swagger spec to output the API documentation which is excellent.
And, based on that OpenAPI spec, we can do much more (hopefully) - like generate client SDKs for various languages.
Current effort is here, but would love to get some community members on this project.