add REST documentation for tenants module

Should probably indicate `the specified tenant` in the return summary here