Features

This chapter covers the core features and capabilities of Tenant Manager.

Features

• Tenant isolation — Thread-local context ensures requests never leak data between tenants
• Context manager — with tenant_scope("tenant_id"): for scoped operations
• Per-tenant config — Feature flags, user limits, storage limits, theming per tenant
• Plan-based limits — Free/Starter/Pro/Enterprise tiers with auto-applied config
• Data partitioning — All CRUD operations automatically scoped to current tenant
• Member management — Add/remove users, role-based access (owner/admin/member/viewer)
• Tenant lifecycle — Create, suspend, reactivate, upgrade plans
• Admin operations — Cross-tenant queries and platform-wide statistics
• JSON persistence — Save/load state for development

Requirements

• Python 3.10+
• No external dependencies (stdlib only)

Quick Start

Follow this guide to get Tenant Manager up and running in your environment.

Quick Start

python src/main.py --init-demo

# List tenants
curl http://localhost:8004/api/tenants

# Create a tenant
curl -X POST http://localhost:8004/api/tenants \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company", "slug": "my-company", "owner_id": "user_1", "plan": "pro"}'

# Add a member
curl -X POST http://localhost:8004/api/tenants/<id>/members \
  -H "Content-Type: application/json" \
  -d '{"user_id": "user_2", "role": "admin"}'

# Platform stats
curl http://localhost:8004/api/admin/stats

API Endpoints