Skip to Content
🎉 New release with new features and improvements! V0.0.5 Release →

Tenants API

The Tenants API provides endpoints for tenant provisioning, lifecycle management, and administration.

For dashboard instructions and general information about tenants, see the Tenants documentation.

Base Endpoint

/api/tenants

Tenant Type

type Tenant = { tenantId: string; name: string; status: 'Active' | 'Inactive' | 'Blocked'; description?: string; email?: string; adminId?: string; settings?: Record<string, unknown>; }

Endpoints

MethodEndpointDescription
POST/api/tenants/{id}/activateActivate a tenant
POST/api/tenants/{id}/deactivateDeactivate a tenant
POST/api/tenants/{id}/blockBlock a tenant
PUT/api/tenants/{id}/admin/{adminId}Assign tenant admin
POST/api/tenantsCreate a tenantSimilar to Entities API
PUT/api/tenantsUpdate a tenantSimilar to Entities API
GET/api/tenants/{id}Get a tenant by IDSimilar to Entities API
GET/api/tenants?page&size&sort&filterList and filter by URI parametersSimilar to Entities API
POST/api/tenants/searchSearch tenants by POSTSimilar to Entities API
DELETE/api/tenants/{id}Delete a tenantSimilar to Entities API
GET/api/tenants/countCount tenantsSimilar to Entities API
POST/api/tenants/countCount filtered tenantsSimilar to Entities API