post https://{applicationQualifiedDomain}.us.wristband.dev/api/v1/tenant-discovery/find-user-tenant
Attempts to find the user's tenant based off the specified application and email. Depending on the number of tenants that are found for the given email and application one of the following operations will be taken.
- If no tenants are found then a 404 response is returned with a
user_not_founderror code. - If exactly one tenant is found then this API will return a
TENANT_FOUNDresult with a redirect URL pointing towards the tenant's login URL. - 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.
NOTE: This API will only match against users that are active and have a verified email. Also, users belonging to tenants of type
GLOBALare never matched against.
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.
| Permission | Boundary | Description |
|---|---|---|
| tenant-discovery-workflow:execute | Application | The subject can perform this operation for requests associated to the application that the subject belongs to. |