add REST documentation for principals module

Looks like this block needs to be cleaned up