Skip to main content
POST
/
v2
/
experiments
/
{experiment_id}
/
runs
Append runs to an experiment
curl --request POST \
  --url https://api.arize.com/v2/experiments/{experiment_id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "experiment_runs": [
    {
      "example_id": "example_001",
      "output": "4",
      "model": "gpt-4o-mini",
      "temperature": 0.2,
      "latency_ms": 118
    },
    {
      "example_id": "example_002",
      "output": "4",
      "model": "gpt-4o-mini",
      "temperature": 0.2,
      "latency_ms": 132
    }
  ]
}
'
{
  "id": "RXhwZXJpbWVudDoxOmFCY0Q=",
  "name": "Experiment 1",
  "dataset_id": "RGF0YXNldDoxOmFCY0Q=",
  "dataset_version_id": "RGF0YXNldFZlcnNpb246MTphQmNE",
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-02T12:00:00Z",
  "run_ids": [
    "run_001",
    "run_002"
  ]
}

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

Path Parameters

​
experiment_id
string
required

The unique experiment identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

Body containing experiment runs to append to the experiment

​
experiment_runs
object[]
required

Array of experiment run data to append to the experiment. Between 1 and 1000 runs per request.

Required array length: 1 - 1000 elements

Response

Experiment with the IDs of the newly inserted runs.

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

​
run_ids
string[]
required

IDs of the newly inserted experiment runs, in input order.

​
experiment_traces_project_id
string

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