DomainModel

This page describes the schema for domain objects that organize related data sources.

DomainModel

id · ID! · required

Unique identifier for the domain.

version · Int! · required

Version number of the domain for change tracking.

name · String! · required

Human-readable name for the domain.

description · String

Optional description explaining the purpose and contents of the domain.

databases · [DatabaseModel!]! · required

List of databases included in this domain. See DatabaseModel.

knowledge · [String!]! · required

Domain-specific knowledge and context information.

domainSystemInstructions · String

Custom system instructions for AI interactions within this domain.

fyStartMonth · Int

Fiscal year start month (1-12) for financial calculations.

vizConfig · VizConfig! · required

Visualization configuration settings. See VizConfig.

codegenConfig · CodegenConfig! · required

Code generation configuration settings. See CodegenConfig.

DatabaseModel

id · ID! · required

Unique identifier for the database.

version · Int! · required

Version number of the database for change tracking.

name · String! · required

Name of the database.

domainId · ID! · required

Identifier of the domain this database belongs to.

connection · Connection

Connection details for accessing this database. See Connection.

isUserCSVDatabase · Boolean! · required

Whether this database was created from user-uploaded CSV files.

Configuration Objects

VizConfig

alwaysUseCompactNumberFormat · Boolean! · required

Whether to always use compact number formatting in visualizations.

openShowDataPanelByDefault · Boolean! · required

Whether to show the data panel by default in visualizations.

CodegenConfig

chatThinkingEffort · ChatThinkingEffort! · required

Level of thinking effort for AI code generation. See ChatThinkingEffort.

Enums

ChatThinkingEffort

The level of thinking effort for AI interactions. This parameter accepts the following values:

Effort Level	Description
Low	Minimal thinking effort for simple queries
Medium	Moderate thinking effort for standard analysis
High	Maximum thinking effort for complex analysis

Additional Resources

Create Domain

Create new domains for organizing data sources

Connection Objects

Learn about connection schema and properties

JobStatus Schema

Understand job execution status tracking