Tenants & organizations
Admin CRUD for tenants — the B2B org boundary in Intry.
Overview
In Prisma and the admin API, a Tenant is the top-level property-management organization. Product docs may call this an "organization" or "company"; the REST path uses /api/admin/tenants.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/admin/tenants | List tenants |
POST | /api/admin/tenants | Create tenant |
POST | /api/admin/tenants/onboard | Full org onboarding flow |
GET | /api/admin/tenants/:id | Fetch one |
GET | /api/admin/tenants/:id/health | Tenant health summary |
GET | /api/admin/tenants/:id/organization | Org profile + billing fields |
PATCH | /api/admin/tenants/:id/organization | Update org (billing: platform admin only) |
GET | /api/admin/tenants/:id/unit-inventory | Unit + VN inventory |
PUT | /api/admin/tenants/:id | Update |
DELETE | /api/admin/tenants/:id | Delete |
Important fields
| Field | Notes |
|---|---|
name | Display name |
planTier | TRIAL, CORE, STANDARD, PRO |
entitlements | JSON module flags; null = all enabled |
stripeCustomerId | Stripe Customer id |
billingPlan / billingStatus | Contract metadata |
Relations
A tenant owns properties, users, devices, and aggregated analytics rows. Deleting a tenant is destructive — confirm cascade rules in Prisma before automating.
See Billing architecture.
Last verified: 2026-06-21 (commit 293c4a7)