To verify that #176 proposed and #199 implemented a conforming HTTP API interface, we should provide an OpenAPI description for it. Once done, it should also help and allow us (or an AI) to write automated tests for it and integrate them into Github actions. Get started [here](https://learn.openapis.org/).
