Skip to main content
POST
/
datasets
/
{slug}
/
items
Create a dataset item
curl --request POST \
  --url https://api.getbasalt.ai/datasets/{slug}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": {
    "columnName1": "value1",
    "columnName2": "value2"
  },
  "name": "Test case 1",
  "idealOutput": "This is the expected output",
  "metadata": {
    "source": "api",
    "context": "testing"
  }
}
'
{
  "datasetRow": {
    "values": {
      "columnName1": "value1",
      "columnName2": "value2"
    },
    "name": "Test case 1",
    "idealOutput": "This is the expected output",
    "metadata": {
      "source": "api",
      "context": "testing"
    }
  },
  "warning": "The following columns do not exist in the dataset and were omitted: extraColumn1, extraColumn2"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
slug
string
required

The slug of the dataset to add an item to

Example:

"my-dataset"

Body

application/json
​
values
object
required

The values for each column in this dataset row

Example:
{
  "columnName1": "value1",
  "columnName2": "value2"
}
​
name
string | null

The name of the dataset row

Example:

"Test case 1"

​
idealOutput
string | null

The ideal output for this dataset row, if any

Example:

"This is the expected output"

​
metadata
object

Additional metadata for this dataset row

Example:
{ "source": "api", "context": "testing" }

Response

The created dataset item

​
datasetRow
object
required

The created dataset row

​
warning
string

Warning message about columns that were omitted because they do not exist in the dataset

Example:

"The following columns do not exist in the dataset and were omitted: extraColumn1, extraColumn2"