add REST documentation for principals module

displayName is required as well