> ## Documentation Index
> Fetch the complete documentation index at: https://docs.esperr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tenants

> Tenant workspace configuration and lifecycle management.

## Tenant lifecycle

The tenant form supports two fields:

* `name`: The tenant name operators see in the console.
* `slug`: The tenant-friendly identifier used in URLs or references.

Create requests:

```text theme={null}
POST /api/v1/tenants
```

Update requests:

```text theme={null}
PATCH /api/v1/tenants/{tenant_id}
```

## Practical guidance

* Create separate tenants for clearly separate customers or environments.
* Keep tenant names obvious, such as `Acme Production`.
* Use memberships to control who can operate a tenant.