FastAPI response schema classes

[pacharanero]

We need to write some FastAPI response schema classes which describe the responses, in order that this will be piped through into the openAPI3 docs.

[eatyourpeas]

now completed