Skip to main content
GET
/
datasets
/
{slug}
Get a dataset by slug
curl --request GET \
  --url https://api.getbasalt.ai/datasets/{slug} \
  --header 'Authorization: Bearer <token>'
{
  "dataset": {
    "slug": "my-dataset",
    "name": "My Dataset",
    "columns": [
      {
        "name": "input",
        "type": "text"
      },
      {
        "name": "output",
        "type": "text"
      }
    ],
    "rows": [
      {
        "values": {
          "columnName1": "value1",
          "columnName2": "value2"
        },
        "idealOutput": "This is the expected output",
        "metadata": {
          "source": "user",
          "context": "testing"
        }
      }
    ]
  },
  "warning": "Some rows contained columns that do not exist in the dataset and were omitted."
}

Documentation Index

Fetch the complete documentation index at: https://docs.getbasalt.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 get

Example:

"my-slug"

Response

The dataset with its items

​
dataset
object
required

The retrieved dataset

​
warning
string

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

Example:

"Some rows contained columns that do not exist in the dataset and were omitted."