Add API docs

[dankinder]

The JSON endpoints in kbexample lack any example of API documentation. We should add that documentation to set a precedent, e.g. with comments somewhere or by autogenerating openapi.