Some of the Models defined in django are not well documented

The "swagger.yaml" file that includes the beat.web api information that can be rendered into the sphinx documentation does not include complete information for all the models included in a response object. Some of the basic ones are shown though which means that the package produces this yaml file is working as expected.

It seems that those objects which are not shown, are not well documented in the code and because there are several layers of inheritance for each class, it is difficult to find where exactly the problem lies.

With a brief discussion with @samuel.gaist we tried something fast but it did not work. It required a deeper dive into the implementation.