add REST documentation for following module

I think this should be re-using the User (or the Basic User) model. I don't think it's a good idea to create new models for the same thing in a bunch of places. As soon as a property changes on the user object, we'll be running into maintenance/out-of-synch issues.