add REST documentation for principals module

Would it make sense to put the required FormParams first, followed by the optional ones? That should make it easier to fill out the form.