Find User Tenant

Attempts to find the user's tenant based off the specified application and email. This API will search for the user's tenants using the following criteria:

1. A user must exist in the tenant with an ACTIVE status and a verified email matching the email from the tenant discovery request. Or, the domain of the email from the request must match one of the tenant's discovery email domains.
2. The tenant must have an ACTIVE status.
3. The tenant can't be of type GLOBAL.

Depending on the number of tenants that are found for the given email and application one of the following operations will be taken.

1. If no tenants are found then a 404 response is returned with a tenant_not_found error code.
2. If exactly one tenant is found then this API will return a TENANT_FOUND result with a redirect URL pointing towards the tenant's login URL.
3. If more than one tenant is found then this API will send a tenant discovery email containing either a verification link or verification code to the specified email address which will allow the user to view the tenants they belong to.

Required Permissions

Below is the list of required permissions needed to interact with this API. For each permission the allowed permission boundaries are also specified.