add REST documentation for principals module

Not sure if `signed` is a valid value for a user import. /cc @simong