add REST documentation for tenants module

* Something doesn't seem right with `@Required   []`
* This is keyed by "tenant alias", not a "tenant id"