tenants
List Tenants
List all tenants (for platform administrators).
Purpose: View all tenants/organizations on the platform
What it does:
- Returns paginated list of all organizations
- Supports filtering by status (active/inactive)
- Used by platform admins to manage customers
- Shows tenant overview for monitoring
Parameters:
limit: Maximum number of tenants to return (default: 100)offset: Number of tenants to skip for pagination (default: 0)status_filter: Filter by tenant status (active/inactive/suspended)
Use Cases:
- Platform administration and monitoring
- Customer account management
- Bulk operations on tenants
- Usage reporting across all customers
GET
List Tenants
Documentation Index
Fetch the complete documentation index at: https://docs.mrassistant.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Successful Response
Required string length:
1 - 255Required string length:
1 - 100Required range:
1 <= x <= 1000Required range:
x >= 0Previous
Create TenantCreate a new tenant (organization/customer) - Usually auto-created during signup.
**⚠️ NOTE: For most users, tenants are AUTO-CREATED during signup!**
**When to use this endpoint:**
- **Platform Admins**: Manually create organizations for customers
- **Recovery**: If auto-creation failed during signup
- **Migration**: Importing existing organizations into the platform
- **Advanced**: Creating additional sub-organizations
**For Regular Users (BUSINESS role):**
- Your tenant is **automatically created** when you sign up via `POST /auth/signup`
- You don't need to call this endpoint
- Your tenant_id = your owner_id (automatically linked)
**What it does:**
- Creates a new tenant account with unique ID (uses current_user.owner_id)
- Sets up billing plan and usage limits
- Configures SIP capabilities (if enabled)
- Establishes compliance settings (HIPAA, PCI)
- Encrypts sensitive credentials (SIP passwords)
**Key Configuration:**
- `name`: Organization name
- `billing_plan`: Subscription tier (starter/business/enterprise)
- `max_concurrent_calls`: Call capacity limit (1-1000)
- `monthly_call_limit`: Monthly usage cap
- `sip_enabled`: Enable phone number integration
- `recording_enabled`: Call recording capability
- `analytics_enabled`: Analytics dashboard access
**User Flow Clarification:**
1. **Sign up** → `POST /auth/signup` (role=BUSINESS) → Tenant auto-created ✅
2. **Login** → `POST /auth/token` → Get access token
3. **Create agents** → `POST /agents` → Start building
❌ You do NOT need to manually create tenant after signup!
Next
List Tenants