Fix REST API docs

Partially implements: blueprint climate-docs
Change-Id: I66d700e4b3d391fefa1d3d6649e3a44b14d9cd5e
Merge "Fix REST API docs"