Skip to main content
POST
cURL
To start fetching data in a dataset, you need to create a data request. A data request is responsible with using your connections to fetch data from your data sources. You can create a data request by using the Create a Data Request endpoint.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id
string
required

ID of the team

Body

application/json
team_id
integer
required
project_ids
integer[]
name
string
connection_id
integer
type
string
query
string
datasetColor
string
dateField
string
dateFormat
string
legend
string

[Legacy compatibility] Previous dataset name field. Prefer name for reusable dataset naming.

configuration
object

Response

Created dataset

id
integer
team_id
integer
project_ids
integer[]
chart_id
integer
connection_id
integer
draft
boolean
default:true
name
string

Canonical dataset name. Prefer this over legend when referring to the reusable dataset itself.

query
string
xAxis
string

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

xAxisOperation
string

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

yAxis
string

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

yAxisOperation
string
default:none

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

dateField
string

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

dateFormat
string

[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.

legend
string

[Legacy compatibility] Previous dataset name field. Prefer Dataset.name for reusable dataset naming.

fieldsSchema
object
excludedFields
string[]
configuration
object
joinSettings
object