Skip to main content
The ax datasets commands let you create, retrieve, and manage datasets on the Arize platform. Supported file formats: CSV, JSON, JSON Lines, Parquet.

​
ax datasets list

List all datasets in a space. 
ax datasets list [--space-id <id>] [--limit <n>] [--cursor <cursor>]
OptionDescription
--space-idFilter by space ID
--limitMaximum number of results to return
--cursorPagination cursor for the next page
Examples: 
ax datasets list --space-id sp_abc123
ax datasets list --space-id sp_abc123 --output datasets.json

​
ax datasets get

Retrieve a single dataset by ID. 
ax datasets get <dataset-id>
Example: 
ax datasets get ds_xyz789

​
ax datasets create

Create a new dataset from a local file. 
ax datasets create --name <name> --space-id <id> --file <path>
OptionDescription
--nameName for the new dataset
--space-idSpace to create the dataset in
--filePath to the data file (CSV, JSON, JSONL, or Parquet)
Example: 
ax datasets create --name "my-eval-set" --space-id sp_abc123 --file ./examples.csv

​
ax datasets list_examples

List examples (rows) within a dataset. 
ax datasets list_examples <dataset-id> [--version-id <id>] [--limit <n>]
OptionDescription
--version-idRetrieve examples from a specific dataset version
--limitMaximum number of examples to return
Examples: 
ax datasets list_examples ds_xyz789
ax datasets list_examples ds_xyz789 --version-id v_123 --output examples.parquet

​
ax datasets delete

Delete a dataset. 
ax datasets delete <dataset-id> [--force]
OptionDescription
--forceSkip the confirmation prompt
Examples: 
ax datasets delete ds_xyz789
ax datasets delete ds_xyz789 --force