Skip to content
Session Services Session Services Logo

Tenant Config & Regions

Bootstrap tenant-specific branding, feature flags, and region metadata.

Tenant endpoints are public bootstrap routes. They require x-tenant-id and do not require a bearer token.

Endpoints

  • GET /tenant/config
  • GET /tenant/regions

Get Full Tenant Config

const { tenant, regions } = await client.tenant.config();

tenant.config is useful for:

  • tenant name, slug, logos, and base URLs
  • default currency
  • feature flags (tenant.features)
  • admin team ID and legacy mapping metadata

Get Regions Only

If you only need region metadata (for filters/navigation), call:

const { regions } = await client.tenant.regions();

HTTP example:

curl https://api.session.services/tenant/regions \
  -H "x-tenant-id: tnt_01jqpj2t2kfvmstt6f6tzkbaf2"

Common Usage

  1. Fetch tenant.config at app startup.
  2. Apply logos/branding and feature gates from the response.
  3. Use regions for country/state/city filtering in event discovery.