Skip to main content
The ax experiments commands let you create, retrieve, and manage experiments on the Arize platform.

​
ax experiments list

List all experiments, optionally filtered by dataset. 
ax experiments list [--dataset-id <id>] [--limit <n>] [--cursor <cursor>]
OptionDescription
--dataset-idFilter experiments by dataset ID
--limitMaximum number of results to return
--cursorPagination cursor for the next page
Example: 
ax experiments list --dataset-id ds_xyz789

​
ax experiments get

Retrieve a single experiment by ID. 
ax experiments get <experiment-id>
Example: 
ax experiments get exp_abc123

​
ax experiments create

Create a new experiment from a local file. The file must contain example_id and output columns. Extra columns are passed through as additional fields. 
ax experiments create --name <name> --dataset-id <id> --file <path>
OptionDescription
--nameName for the new experiment
--dataset-idDataset ID to attach the experiment to
--filePath to the data file (CSV, JSON, JSONL, or Parquet) with experiment runs
Example: 
ax experiments create --name "my-experiment" --dataset-id ds_xyz789 --file ./runs.csv

​
ax experiments list_runs

List runs for an experiment. 
ax experiments list_runs <experiment-id> [--limit <n>]
OptionDescription
--limitMaximum number of runs to return
Example: 
ax experiments list_runs exp_abc123
ax experiments list_runs exp_abc123 --output runs.parquet

​
ax experiments delete

Delete an experiment. 
ax experiments delete <experiment-id> [--force]
OptionDescription
--forceSkip the confirmation prompt
Examples: 
ax experiments delete exp_abc123
ax experiments delete exp_abc123 --force