* refactor: helper method for register swagger api * updates swagger.yaml * `make update-swagger-docs`