add REST documentation for principals module

Can you change this to `BasicPrincipal` or `Principal`