add REST documentation for principals module

I was going to go through all of them for one last check and them move them to review state. Doing that this morning.