​
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. Values:
  • 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