Skip to main content
POST
/
datasets
/
upsert
Upsert Dataset
curl --request POST \
  --url https://api.example.com/datasets/upsert/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataset_name": "<string>",
  "row_unique_identifier": "<string>",
  "data": [
    {}
  ],
  "data_schema": {}
}
'
{}

Authorizations

​
Authorization
string
header
required

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

Headers

​
Api-key
string | null

Query Parameters

​
check_schema
boolean
default:true

Body

application/json
​
dataset_name
string
required

The name of the dataset to be inserted or updated.

​
row_unique_identifier
string
required

The column name that can uniquely identify the row in the dataset, normally an id column.

​
data
Data · object[]
required

The data rows in the format of list of json object, where each json object in the list is a single row. The json objects need to have identical top level fields. The max size is 1G.

​
data_schema
Data Schema · object

Optional. specify the schema in the 'data' field. It contains key value pairs of { column_name : column_type }. column_name is the top level field in the JSON objects, DO NOT provide the inner nested fields. Valid value for column types are: 'INTEGER', 'FLOAT', 'STRING', 'BOOLEAN': 'JSON'

Response

Successful Response

The response is of type Response Upsert Dataset Datasets Upsert Post · object.