add REST documentation for principals module

Path parameter is missing here. I'll update