Tenants, Domains & Users

Tenant creation is platform-scoped — it requires a super_admin caller. Everything else here is scoped to the caller’s own tenant unless they’re super_admin acting via X-Tenant-ID.

Tenants

Method	Path	Purpose
`GET`	`/api/v1/tenants`	List tenants (`super_admin` only)
`POST`	`/api/v1/tenants`	Create a tenant — idempotent on slug
`GET`	`/api/v1/tenants/{tenant_id}`	Fetch one tenant
`PATCH`	`/api/v1/tenants/{tenant_id}`	Update tenant fields
`DELETE`	`/api/v1/tenants/{tenant_id}`	Soft-delete a tenant
`GET`/`PATCH`	`/api/v1/tenants/{tenant_id}/settings`	Per-tenant settings (budget, feature overrides)

curl -X POST https://api.mael.in/api/v1/tenants \
  -H "Authorization: Bearer $SUPER_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "dr-chandril-chugh",
    "name": "Dr Chandril Chugh",
    "plan_tier": "starter",
    "timezone": "Asia/Kolkata"
  }'

For a repeatable, reviewed provisioning flow instead of hand-typed curl calls, see CLI → Onboarding — it drives these same endpoints.

Domains

Method	Path	Purpose
`GET`/`POST`	`/api/v1/tenants/{tenant_id}/domains`	List / attach a domain
`GET`/`PATCH`/`DELETE`	`/api/v1/tenants/{tenant_id}/domains/{domain_id}`	Manage one domain

Users

Method	Path	Purpose
`GET`/`POST`	`/api/v1/users`	List / create users (tenant-scoped; requires `users:write`)
`GET`/`PATCH`	`/api/v1/users/me`	The caller’s own profile
`GET`/`PATCH`/`DELETE`	`/api/v1/users/{user_id}`	Manage a specific user

POST /api/v1/users cannot create a super_admin — that account only exists via the one-time bootstrap_admin.py script. See Quickstart.

API Reference

API Endpoints

Tenants, Domains & Users

Tenants

Domains

Users

​Tenants

​Domains

​Users

Tenants

Domains

Users