add REST documentation for tenants module

This is a true id, not a short name. I'll follow-up