Add response objects in API spec
Add response objects as described in #19 (closed).
To avoid inline definition of responses, add one "top level" response object and then one specialized response object for every other type of entity (vm, software, etc) to then include those in the actual endpoint definitions.