Improve api documentation

[galbwe]

Run the swagger docs locally by starting the api with docker compose

docker compose up --build

Follow the instructions in the README to access the docs

Some of the endpoints only have response schemas for the 200 responses. One direction is to add response schemas for error responses. Check the blueprints directory in the backend for the definitions of the endpoints and their responses.

Refer to the swagger 2 docs for additional swagger features to add. Pretty much any improvement on the existing docs is welcome!