---
title: "Multi-Tenancy"
---

# Multi-Tenancy

Build SaaS applications with built-in tenant isolation, quotas, and change data capture.

## Tenant Management

### Create Tenant

```bash
\tenant create acme_corp enterprise schema
```

### List Tenants

```bash
\tenants
```

### Switch Tenant Context

```bash
\tenant use acme_corp
```

## Isolation Levels

| Level | Description |
|-------|-------------|
| `shared` | Logical isolation via tenant_id column |
| `schema` | Per-tenant schema isolation |
| `database` | Full database isolation |

## Quotas

### Set Quotas

```bash
\tenant quota set acme storage=10GB connections=50 qps=1000
```

### View Usage

```bash
\tenant usage acme
```

## Plans

```bash
\tenant plans                    # List plans
\tenant plan create pro tier=2 storage=50GB
\tenant plan acme_corp pro       # Assign plan
```

## Change Data Capture (CDC)

```bash
\tenant cdc                      # View recent events
\tenant cdc export events.json   # Export to file
```

## API Endpoints

```
GET  /v1/tenants
POST /v1/tenants
GET  /v1/tenants/{id}/usage
POST /v1/tenants/context
```

## Related

- [Row-Level Security](https://www.heliosdb.com/docs/lite/features/rls/) - Policy-based access control
- [API Reference](https://www.heliosdb.com/docs/lite/api/rest-api/) - Tenant API endpoints