As a developer I need the full OpenAPI specification, so I am able to implement the API v3

[wmelder]

• install editor and import current spec Swagger editor
• given the API specification, complete the openapi description