FEATURES
Environments
Deployment targets (dev, uat, prod) with isolated feature flags and chatbot config.
Overview
Deployment targets (dev, uat, prod) with isolated feature flags and chatbot config.
Who should use this
Customers using multi_environment mode or separating staging from production.
Core concepts
Single mode hides switcher; multi mode drives per-environment entitlements via feature matrix.
Setup
Created with workspace from template, or POST /tenants/{tenantId}/environments?workspaceId=...
Required entitlement
multi_environment for more than one visible environment.
Required permissions
environment.view, environment.update (allowedDomains for widget).
REST API
GET/PATCH /tenants/{tenantId}/environments/{environmentId}.
SDK (@startupcore/api-client)
startupCore.environments.list(tenantId, { workspaceId }).
React components
<EnvironmentSwitcher />.
Security notes
allowedDomains on environment restricts widget embed origins.
Troubleshooting
Widget blocked — add your origin to environment.allowedDomains.