Please refer examples for Documentation : https://github.com/khacksOSS/kapp-api/pull/22 Document all the API and Models Some useful links https://swagger.io/docs/specification/components/ Follow https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md Convention