> For the complete documentation index, see [llms.txt](/docs/llms.txt)

# Tenants API | FusionAuth Docs

Learn about the APIs for creating, retrieving, updating and deleting tenants.

# 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.

| Operation | Method | Endpoint |
| --- | --- | --- |
| [Create a Tenant](/docs/apis/tenants/create-a-tenant) | `POST` | `/api/tenant`  
`/api/tenant/{tenantId}` |
| [Retrieve a Tenant](/docs/apis/tenants/retrieve-a-tenant) | `GET` | `/api/tenant`  
`/api/tenant/{tenantId}` |
| [Search for Tenants](/docs/apis/tenants/search-for-tenants) | `GET`  
`POST` | `/api/tenant/search?name={name}`  
`/api/tenant/search` |
| [Update a Tenant](/docs/apis/tenants/update-a-tenant) | `PUT` | `/api/tenant/{tenantId}` |
| [Delete a Tenant](/docs/apis/tenants/delete-a-tenant) | `DELETE` | `/api/tenant/{tenantId}` |
| [Retrieve the Password Validation Rules](/docs/apis/tenants/retrieve-the-password-validation-rules) | `GET` | `/api/tenant/password-validation-rules/{tenantId}` |