add REST documentation for principals module

Do we know if file uploads through Swagger are now working?