add REST documentation for principals module

Maybe it's easier to create a follow-up ticket that you can address once all initial documents PRs have been merged. Would you mind creating that ticket?