add REST documentation for principals module

Can we rename this model to `MembeshipUpdate`?