# Tenant Management

Runmerge is designed to support multi-tenant architecture, allowing Eventtechs to manage multiple customers while ensuring data isolation and security. Each customer (or organization) using Runmerge is treated as a logical tenant, meaning their data remains separate from other tenants while sharing the same underlying infrastructure.

# Key Concepts

# 1. Logical Tenants

A tenant represents an organization or customer using Runmerge to manage event data. Each tenant has its own:

  • Events
  • People (Attendees, Speakers, etc.)
  • Sessions
  • Exhibitors
  • Sponsors
  • Tickets
  • Resources

This ensures that data does not mix between different customers, even when multiple tenants use the same API instance.

# 2. Data Isolation

Runmerge enforces strict isolation between tenants:

  • API Requests: Each request is scoped to a specific tenant, ensuring that no data from other tenants is accessible.
  • Authentication & Authorization: API keys or tokens are tied to a tenant, preventing unauthorized access to other tenants' data.
  • Storage Separation: Even though data is stored within a shared database, logical segmentation ensures that each tenant’s records are distinct.

# 3. Tenant-Based Filtering

When querying data, the API allows filtering by tenant. This ensures that:

  • Clients can retrieve only the data they have permissions for.
  • Eventtechs managing multiple tenants can request data per tenant without mixing results.

Example use case:

  • A SaaS platform integrating with Runmerge can manage multiple event organizers under a single integration while keeping each organizer’s data isolated.

# 4. Access Control & Permissions

Each tenant can have different levels of access control:

  • Admins can manage all aspects of the tenant’s data.
  • Event managers may have access to only specific events.
  • Read-only roles can retrieve data but not modify it.

# 5. Scalability & Performance

  • Runmerge is optimized to handle thousands of tenants in parallel.
  • Data is indexed to ensure efficient querying and retrieval even at scale.
  • Webhooks and real-time updates respect tenant boundaries to deliver relevant updates only to authorized subscribers.

# Benefits of Tenant Management in Runmerge

Security & Compliance → Ensures customer data is always isolated.
Scalability → Supports growing numbers of tenants without performance issues.
Simplified Integration → Eventtechs can manage multiple customers from a single API.
Flexible Access Control → Fine-grained permissions for different user roles.