List workspaces

GET

/api/workspaces

Production

Returns workspaces accessible to the authenticated user. Owners and admins see all workspaces in the tenant. Agents and observers only see workspaces they are assigned to. Billing users see none.

Authorizations

bearerAuth

Responses

200

An array of accessible workspaces. May be empty if the user has no workspace assignments.

A list of workspaces accessible to the authenticated user. Agents and observers only see workspaces they are assigned to; owners and admins see all.

Array<object>

A workspace is an operational unit within a brand, typically representing a region, business unit, or product line. Conversations, knowledge base entries, policies, and channels are all scoped to a workspace.

object

required

Unique identifier for the workspace.

string format: uuid

Example

w1a2b3c4-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this workspace belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

brandId

required

The brand this workspace operates under. Determines tone, sender identity, and email templates.

string format: uuid

Example

b1a2c3d4-5678-9abc-def0-1234567890ab

name

required

Display name of the workspace.

string

Example

DACH Region

country

required

ISO 3166-1 alpha-2 country code for this workspace’s primary operating region. Affects currency defaults and compliance.

string

Example

DE

operatingLanguage

required

The primary language the AI uses when communicating in this workspace. ISO 639-1 code.

string

Example

de

currency

required

ISO 4217 currency code used for financial references in this workspace.

string

Example

EUR

workspaceType

required

Whether this workspace handles business-to-business or business-to-consumer conversations. Affects contact resolution, account enrichment, and AI behavior.

string

Allowed values: b2b b2c

Example

b2b

workspaceInstructions

Free-text instructions specific to this workspace. These are combined with brand instructions to guide the AI. Use for workspace-specific rules like regional regulations or product-specific guidance.

string | null

Example

All prices must include VAT. Refer customers to the German returns policy for DACH orders.

emailSignatureHtml

Workspace-level HTML email signature. Overrides the brand-level signature when set.

string | null

Example

<p>Freundliche Gruesse,<br>Ihr Acme DACH Team</p>

emailSignatureText

Workspace-level plain-text email signature. Overrides the brand-level signature when set.

string | null

Example

Freundliche Gruesse,
Ihr Acme DACH Team

createdAt

required

Timestamp when the workspace was created.

string format: date-time

Example

2026-01-20T10:00:00.000Z

updatedAt

required

Timestamp when the workspace was last updated.

string format: date-time

Example

2026-03-01T16:45:00.000Z