The API should provide a generated swagger.json and respective swagger UI. This is already provided by the flask-restful clone flask-restplus. We simply need to migrate and implement all endpoints as flask-restplus resources. All users of the API should migrate to swagger afterwards.
move to flask-restplus
refactor all endpoints to flask-restplus
client.py uses swagger (via bravado)
GUI uses swagger (via swagger-client/swagger-js)