Multi-tenancy

Multi-tenancy allows a single application to serve multiple customers with complete data isolation and customization. ShipOS provides enterprise-grade multi-tenancy with flexible organizational structures that scale seamlessly.

The multi-tenant architecture separates data at the database level while sharing application infrastructure. Each organization has its own data namespace, ensuring complete privacy and security between tenants while maintaining cost-effective resource utilization.

Creating and managing organizations with custom settings:

const organization = await shipos.organizations.create({
  name: 'Acme Corporation',
  subdomain: 'acme',
  settings: {
    maxUsers: 100,
    features: ['advanced_analytics']
  }
});

await shipos.organizations.addMember(organization.id, {
  userId: user.id,
  role: 'admin'
});

const organization = await shipos.organizations.create({
  name: 'Acme Corporation',
  subdomain: 'acme',
  settings: {
    maxUsers: 100,
    features: ['advanced_analytics']
  }
});

await shipos.organizations.addMember(organization.id, {
  userId: user.id,
  role: 'admin'
});

const organization = await shipos.organizations.create({
  name: 'Acme Corporation',
  subdomain: 'acme',
  settings: {
    maxUsers: 100,
    features: ['advanced_analytics']
  }
});

await shipos.organizations.addMember(organization.id, {
  userId: user.id,
  role: 'admin'
});

Each organization can have custom settings, branding, and feature sets. This enables you to offer different tiers of service or customization levels to different customers. Organizations can have their own subdomains, custom domains, and completely branded experiences.

Four cards displaying company plans: Acme Corp, GoodTech Inc, Research Labs, and DevTeam.

User management within organizations supports hierarchical roles. Organization admins can invite new users, assign roles, and manage permissions without requiring access to your main application administration, reducing support overhead and improving security.

Data isolation is enforced at the API level and database level. Users can only access data within organizations they belong to. Cross-organization data access is prevented by default, with explicit permissions required for any shared resources, ensuring complete tenant separation.

‹ Webhooks

Monitoring ›