add REST documentation for principals module

Looks like there are spacing issues here. Not everything seems to be aligning.