Create a new dataset

curl --request POST \
  --url https://api.arize.com/v2/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Math Questions Dataset",
  "spaceId": "space_12345",
  "examples": [
    {
      "question": "What is 2 + 2?",
      "answer": "4",
      "topic": "arithmetic"
    },
    {
      "question": "What is the square root of 16?",
      "answer": "4",
      "topic": "geometry"
    },
    {
      "question": "If 3x = 12, what is x?",
      "answer": "4",
      "topic": "algebra"
    }
  ]
}
'

{
  "id": "<string>",
  "name": "<string>",
  "spaceId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "versions": [
    {
      "id": "<string>",
      "name": "<string>",
      "datasetId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Datasets

Create a new dataset

Create a new dataset with JSON examples. Empty datasets are not allowed. Dataset names must be unique within a given space.

Example payload

Each item in examples[] may contain any user-defined fields.
Do not include system-managed fields on input: id, created_at, updated_at. Requests that contain these fields in any example will be rejected.
Each example must contain at least one property (i.e., {} is invalid).

Valid example (create)

{
  "name": "my-dataset",
  "spaceId": "spc_123",
  "examples": [
    { "question": "What is 2+2?", "answer": "4", "topic": "math" }
  ]
}

Invalid example (contains system fields)

{
  "name": "my-dataset",
  "spaceId": "spc_123",
  "examples": [
    { "id": "ex_1", "input": "Hello" }   // ❌ 'id' not allowed on create
  ]
}

⚠️ Beta Warning: This endpoint is in beta, read more here.

POST

datasets

Create a new dataset

curl --request POST \
  --url https://api.arize.com/v2/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Math Questions Dataset",
  "spaceId": "space_12345",
  "examples": [
    {
      "question": "What is 2 + 2?",
      "answer": "4",
      "topic": "arithmetic"
    },
    {
      "question": "What is the square root of 16?",
      "answer": "4",
      "topic": "geometry"
    },
    {
      "question": "If 3x = 12, what is x?",
      "answer": "4",
      "topic": "algebra"
    }
  ]
}
'

{
  "id": "<string>",
  "name": "<string>",
  "spaceId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "versions": [
    {
      "id": "<string>",
      "name": "<string>",
      "datasetId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

Authorization

string

header

required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Authorization: Bearer <api-key>

Body

application/json

Body containing dataset creation parameters

name

string

required

spaceId

string

required

examples

object[]

required

Array of examples for the new dataset

Show child attributes

examples.{key}

Additional user-defined fields in the dataset example

Response

A dataset object

A dataset is a structured collection of examples used to test and evaluate LLM applications. Datasets allow you to test models consistently across any real-world scenarios and edge cases, quickly identify regressions, and track measurable improvements.

string

required

Unique identifier for the dataset

name

string

required

Name of the dataset

spaceId

string

required

Unique identifier for the space this dataset belongs to

createdAt

string<date-time>

required

Timestamp for when the dataset was created

updatedAt

string<date-time>

required

Timestamp for the last update of the dataset

versions

object[]

List of versions associated with this dataset

Show child attributes

versions.id

string

required

Unique identifier for the dataset version

versions.name

string

required

Name of the dataset version

versions.datasetId

string

required

Unique identifier for the dataset this version belongs to

versions.createdAt

string<date-time>

required

Timestamp for when the dataset version was created

versions.updatedAt

string<date-time>

required

Timestamp for the last update of the dataset version

List datasets Get a dataset

⌘I

REST API

Reference

Create a new dataset

Authorizations

Body

Response