POST
/
api
/
v1
/
dataset
/
upsert

Authorizations

Authorization
string
headerrequired

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

Body

application/json
id_column
string | null

the column in the dataset that contains the unique id for each record. this must be included if the dataset id is not provided

name
string | null

the name of the dataset. this must be included if the dataset id is not provided

dataset_id
string | null

if you want to update an existing dataset, pass the dataset id here

records
object[]

the records to be added to the dataset. each record should include at least the id column key and value

additional_metadata
object | null

additional metadata to be stored with the dataset, should be generally be ignored

include_id_column
boolean
default: false

whether or not the id column influences the content of the records and should be included. If the id column is random for example it should not be included. Default is false

Response

200 - application/json
dataset_id
string
required
error_message
string | null
required