FEATURES

Workspaces

Logical product or site inside a tenant (marketplace, single business, personal site).

Overview

Logical product or site inside a tenant (marketplace, single business, personal site).

Who should use this

Teams running multiple products under one billing account.

Core concepts

workspace.templateKey selects environment mode and default features (e.g. startupcore_marketplace_default).

Setup

POST /tenants/{tenantId}/workspaces with name, slug, templateKey.

Required entitlement

organizations

Required permissions

workspace.view, workspace.create, workspace.update.

REST API

CRUD under /tenants/{tenantId}/workspaces/{workspaceId}.

SDK (@startupcore/api-client)

startupCore.workspaces.list(tenantId), .create(tenantId, body).

React components

<WorkspaceSwitcher workspaces={...} value={id} onChange={...} />.

Security notes

Slug must be unique per tenant.

Troubleshooting

404 — verify workspaceId belongs to tenant in JWT.