add REST documentation for principals module

Still needs follow-up