add REST documentation for principals module

`following` information seems to be missing in the full profile