Skip to main content
POST
/
v2
/
experiments
Create an experiment
curl --request POST \
  --url https://api.arize.com/v2/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Experiment Name",
  "dataset_id": "dataset_12345",
  "experiment_runs": [
    {
      "example_id": "example_001",
      "output": "4",
      "model": "gpt-4o-mini",
      "temperature": 0.2,
      "latency_ms": 118,
      "prompt": "Answer the math question briefly."
    },
    {
      "example_id": "example_002",
      "output": "4",
      "model": "gpt-4o-mini",
      "temperature": 0.2,
      "latency_ms": 132
    },
    {
      "example_id": "example_003",
      "output": "4",
      "model": "gpt-4o-mini",
      "temperature": 0.2,
      "latency_ms": 125
    }
  ]
}
'
{
  "id": "exp_001",
  "name": "Experiment 1",
  "dataset_id": "dataset_001",
  "dataset_version_id": "dv_001",
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-02T12:00:00Z"
}

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

Body

application/json

Body containing experiment creation parameters

​
name
string
required

Name of the experiment

​
dataset_id
string
required

ID of the dataset to create the experiment for

​
experiment_runs
object[]
required

Array of experiment run data

Response

An experiment object

Experiments combine a dataset (example inputs/expected outputs), a task (the function that produces model outputs), and one or more evaluators (code or LLM judges) to measure performance. Each run is stored independently so you can compare runs, track progress, and validate improvements over time. See the full definition on the Experiments page.

Use an experiment to run tasks on a dataset, attach evaluators to score outputs, and compare runs to confirm improvements.

​
id
string
required

Unique identifier for the experiment

​
name
string
required

Name of the experiment

​
dataset_id
string
required

Unique identifier for the dataset this experiment belongs to

​
dataset_version_id
string
required

Unique identifier for the dataset version this experiment belongs to

​
created_at
string<date-time>
required

Timestamp for when the experiment was created

​
updated_at
string<date-time>
required

Timestamp for the last update of the experiment

​
experiment_traces_project_id
string

Unique identifier for the experiment traces project this experiment belongs to (if it exists)