API documentation

Referring to my earlier comment at "Scheduling breaking changes we have on our radar", I think adopting OpenAPI specification to build a REST API would be beneficial in achieving such a public API.