Skip to main content
POST
Create a model

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format: Bearer <basedash_api_key>

Path Parameters

orgId
string
required

Organization ID

Body

application/json
name
string
required

Human-readable model name

Required string length: 1 - 100
databaseConnectionId
string
required

Data source ID

sqlQuery
string
required

SQL query that defines the reusable dataset

Required string length: 1 - 100000
referenceName
string

Stable SQL reference name for the model

Required string length: 1 - 100
description
string

Model description

Maximum string length: 10000
measures
object[]

Ordered reusable aggregate expressions

Maximum array length: 50
segments
object[]

Ordered reusable predicate expressions

Maximum array length: 50
defaultTimeColumn
string | null

Default date result column, or null for no default

Required string length: 1 - 256

Response

Model created successfully

data
object
required