🤖 For AI agents: The complete documentation index is available at /docs/llms.txt. A markdown version of this page is available at /docs/apis/tenants/index.md.

Tenants API

A FusionAuth Tenant is a named object that represents a discrete namespace for Users, Applications and Groups. A user is unique by email address or username within a tenant.

Tenants may be useful to support a multi-tenant application where you wish to use a single instance of FusionAuth but require the ability to have duplicate users across the tenants in your own application. In this scenario a user may exist multiple times with the same email address and different passwords across tenants.

Tenants may also be useful in a test or staging environment to allow multiple users to call APIs and create and modify users without possibility of collision.

The following APIs are provided to manage Tenants.

The following APIs provide a subset of the Tenant configuration without an API Key.

OperationMethodEndpoint
Create a TenantPOST/api/tenant
/api/tenant/{tenantId}
Retrieve a TenantGET/api/tenant
/api/tenant/{tenantId}
Search for TenantsGET
POST
/api/tenant/search?name={name}
/api/tenant/search
Update a TenantPUT/api/tenant/{tenantId}
Delete a TenantDELETE/api/tenant/{tenantId}
Retrieve the Password Validation RulesGET/api/tenant/password-validation-rules/{tenantId}