Define models in OpenAPI spec

[bc3tech]

The models for return values should be defined in the OpenAPI spec; this will allow for API generation libraries to create strongly-typed returns for endpoint calls. As-is, generated libs simply return object or any which is both not helpful and inefficient.