API Reference
Libraries
API Overview
Datasets
Create a dataset from file upload, HuggingFace, Kaggle, or Google Sheets
POST/api/v1/datasets
Get a dataset by ID
GET/api/v1/datasets/{dataset_id}
List datasets
GET/api/v1/datasets
Get the processing status of a dataset
GET/api/v1/datasets/{dataset_id}/status
Download the processed dataset
GET/api/v1/datasets/{dataset_id}/download
Publish a dataset to an external platform
POST/api/v1/datasets/{dataset_id}/publish
Start an adaptation run (or estimate cost)
POST/api/v1/datasets/{dataset_id}/run
Add rows to a dataset from the curated pool
POST/api/v1/datasets/{dataset_id}/augment
Add translated rows to a dataset
POST/api/v1/datasets/{dataset_id}/translate
Add localized rows to a dataset
POST/api/v1/datasets/{dataset_id}/localize
Get evaluation results for a dataset
GET/api/v1/datasets/{dataset_id}/evaluation
Generate a dataset from scratch
POST/api/v1/datasets/invent
List the domains and subdomains available for generation
GET/api/v1/datasets/invent/domains
Delete a dataset
DELETE/api/v1/datasets/{dataset_id}
Poll saved URLs for successful dataset exports (Hugging Face, Kaggle, Google Sheets)
GET/api/v1/datasets/{dataset_id}/export-links
Best fine-tune launch config for re-launch parity
GET/api/v1/datasets/{dataset_id}/finetune/best-launch-config
DatasetsUpload
Initiate a dataset upload
POST/api/v1/datasets/upload/initiate
Complete a dataset upload and trigger processing
POST/api/v1/datasets/upload/complete
Complete a file upload and trigger processing
POST/api/v1/datasets/{dataset_id}/upload/complete
Initiate a batch upload
POST/api/v1/datasets/upload/initiate-batch
Complete a batch upload and trigger processing
POST/api/v1/datasets/upload/complete-batch
DatasetsCombine
Combine multiple Datasets into a single new merged Dataset
POST/api/v1/datasets/combine
Validate that a set of Datasets can be combined
POST/api/v1/datasets/combine/validate
DatasetsCombineJobs
Get the status of a background dataset combine job
GET/api/v1/datasets/combine/jobs/{combine_job_id}
DatasetsCustom Evals
Start a custom-rubric evaluation for an adapted dataset
POST/api/v1/datasets/{dataset_id}/custom-evals
List custom-rubric evaluations for a dataset, newest first
GET/api/v1/datasets/{dataset_id}/custom-evals
Get a single custom-rubric evaluation
GET/api/v1/datasets/{dataset_id}/custom-evals/{custom_eval_id}
Draft a judge rubric tailored to an adapted dataset
POST/api/v1/datasets/{dataset_id}/custom-evals/prepare
Autoscientist
Create an AutoScientist run
POST/api/v1/autoscientist
Recommend hyperparameters
POST/api/v1/autoscientist/recommend-hyperparams
Retrieve an AutoScientist run
GET/api/v1/autoscientist/{experiment_id}
List AutoScientist runs
GET/api/v1/autoscientist
Cancel an AutoScientist run
POST/api/v1/autoscientist/{experiment_id}/cancel
Download the best trained model artifact
GET/api/v1/autoscientist/{experiment_id}/download
List available base models for training
GET/api/v1/autoscientist/models