Per comments with GSS, it would be very useful to have an official API guide in the same way that satellite does.
Latest documentation can be found here: https://fedorahosted.org/katello/wiki/ApiDocLatest Changing assignement to Lana :)
*** This bug has been marked as a duplicate of bug 837338 ***